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Android 是 一 个 迅速 向 各 个 领域 扩张 的 生态 系统 。 每 天 都 会 有 厂商 发 布 新 的 设备 和 外 观 设计 ， 每 天 都 会 有 客户 购买 和 激活 上 
百 万 台 设 备 ， 每 天 都 会 有 用 户 下 载 和 试用 新 的 应 用 程序 。 开 发 美观 、 有 吸引 力 并 且 令 用 户 满意 的 应 用 程序 来 丰富 和 完善 这 个 生态 
系统 是 每 一 位 开发 者 〈 布 望 也 包括 读者 本 人 ) 应 尽 的 责任 ， 只 有 这 样 才能 为 用 户 提 供 更 好 的 交互 体验 。 


Android 是 一 个 软件 开发 平台 ， 它 诞生 于 2003 年 年 底 ， 由 Danget 公 司 ( 开 发 流行 的 Sidekick 手 机 的 公司 ) 的 前 雇员 开发 。2005 
年 ， 运 营 Android 的 Danget 公 司 被 Google 公 司 收 购 。 三 年 后 ，HTC Dream (G1) 作为 第 一 款 运行 Android 操 作 系 统 的 手机 正式 发 
布 。 此 后 三 年 ， 虽 然 硬 件 与 平台 发 生 了 很 大 的 更 新 和 迭代， 但 是 Andtoid 依 然 保 持 为 一 个 单纯 的 手机 操作 系统 。 


2011 年 ，Google 公 司 为 Android 添 加 了 新 的 特性 ， 增 加 了 对 两 种 设备 的 支持 : 平板 电脑 和 电视 。 这 不 仅 标 志 着 官方 第 一 次 扩 
充 Android 所 支持 设备 的 种 类 ， 还 激发 了 厂商 对 其 他 潜在 支持 设备 的 兴 超 。 现 在 ，Android 已 经 可 以 运行 在 笔记 本 电脑 、 手 表 、 视 
频 游戏 机 、 车 载 音 响 等 多 种 设备 上 。 我 相信 在 不 久 的 将 来 Android 会 支持 更 多 的 设备 。 


作为 应 用 开发 者 ， 理 解 平台 的 多 样 化 和 发 展 方向 是 非常 重要 的 。 在 Android 上 做 开发 已 经 不 像 为 竖 屏 手机 设计 软件 那么 简单 


了 。 尽 管 这 意味 着 开发 者 开发 应 用 程序 的 工作 量 增加 了 ，, 但 是 ， 最 终结 果 却 是 无 论 应 用 程序 运行 在 哪 种 设备 上 ， 都 会 为 使 用 者 提 
供 恨 好 的 用 户 体 验 。 


在 开发 应 用 程序 的 过 程 中 ， 除 了 个 人 创造 力 和 开发 意愿 以 外 ， 开 发 者 还 需要 具备 三 样 东西 : 平台 开发 文档 、 开 源 社区 以 及 整 

资源 并 融会 贯通 的 能 力 。 平 台 开 发 文档 比较 容易 获取 ， 最 新 版 本 托管 在 http://developet.android.com 网 站 上 。 开 源 社区 有 
GitHub, Google Code, Stack Overflow 以 及 其 他 类 似 网 站 ， 这 些 网 站 提供 了 开源 库 、 代 码 片 段 以 及 能 够 简化 程序 开发 的 设计 模 
式 。 此 外 ， 开 发 者 还 需要 具备 把 上 述 零 艇 的 知识 整合 到 应 用 中 的 能 力 。 这 个 整合 的 过 程 可 不 像 搭 积木 一 样 简单 ， 如 果 那 样 ， 任 何 
人 都 可 以 开发 应 用 了 。 本 书 便 是 一 本 分 析 如 何 整合 资源 的 指南 。 


本 书 以 示例 程序 的 形式 分 析 如 何 解决 Andtoid 开 发 过 程 中 出 现 的 第 见 问题 。 书 中 有 些 示例 程序 相对 简单 ， 有 些 示 例 程序 相当 
复杂 。 这 些 示 例 程 序 分 享 了 一 些 只 有 零散 或 者 零星 文档 可 查 但 是 却 经 第 困扰 开发 者 的 问题 。 本 书 不 仅仅 是 一 本 单纯 学 习 和 掌握 
Android 开 发 技巧 的 书 ， 更 是 一 本 填补 空白 的 书 。 


精心 设计 一 个 能 够 动态 支持 所 有 Android 设 备 的 应 用 是 一 项 艰巨 的 任务 。 通 过 学 习 本 书 以 及 类 似 出 版 物 和 在 线 资 源 提供 的 知 
识 ， 我 希望 能 提升 读者 开发 和 发 布 应 用 的 能 力 。 除 此 之 外 ， 我 跟 读 者 一 样 ， 也 是 一 名 开发 者 和 热心 用 户 ， 我 也 在 耐心 等 待 下 一 个 
精彩 应 用 的 出 现 ， 或 许 读者 就 是 那个 开发 它 的 人 。 


Jake Wharton 
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早 在 2009 年 我 便 开 始 研 究 Android。 当 时 ，Android 1.5 刚 刚 发 布 并 且 显 示 出 巨大 的 发 展 潜力 。 


在 2009 年 7 月 ， 得 益 于 澳大利亚 的 一 位 朋友 ， 我 拿 到 了 第 一 人 台 运 行 Android 操 作 系 统 的 设备 ， 这 台 设 备 就 是 运行 Android 1.567 
HTC Magic 手 机 。 说 实话 ， 这 台 设 备 的 运行 速度 比 我 想象 的 要 慢 , 但 是 我 依然 通过 它 开 始 研 究 Android 的 API[， 并 且 根 据 自 己 的 需 
求 开发 应 用 程序 ， 然 后 在 这 台 设 备 上 运行 这 些 应 用 。 当 时 ， 我 预感 到 Android 会 获得 更 多 人 的 关注 ， 我 相信 如 果 我 能 为 Android 开 
发 一 款 应 用 程序 ， 这 款 应 用 程序 一 定 能 被 许多 人 使 用 。 


事实 证 明 ， 我 的 预感 是 正确 的 。 不 久 后 ，Andtoid 开 发 的 大 幕 便 拉 开 了 ， 而 且 发 展 得 越 来 越 快 。 一 时 间 ， 许 多 支持 Andtoid 平 
台 的 工具 和 第 三 方 开 发 库 便 涌现 出 来 ， 从 cocos2d-x 这 样 的 游戏 框架 到 Apache Maven 这 样 的 编译 系统 ， 几 乎 无 所 不 包 


2010 年 11 月 ， 我 受 邀 审阅 Manning 出 版 社 出 版 的 《Andtroid in Practice? — (www.manning.com/collins/) 一 书 。 当 深度 参与 到 这 
项 工作 之 后 ， 我 突然 想到 ， 我 可 以 用 另 一 种 方法 写 一 本 Andtoid 开 发 的 书 。 我 打算 模仿 Joshua Bloch 所 著 的 《Effective Java» 
(www.amazon.com/Effective-Java2nd-Joshua-Bloch/dp/0321356683) 一 书 的 风格 ， 向 读者 展示 这 些 年 来 我 在 Android 开 发 过 程 中 总 
结 的 小 窍门 和 开发 模式 。 


从 根本 上 讲 ， 我 想 在 一 本 书 里 涵盖 开发 过 程 中 总 结 的 我 知道 的 所 有 小 窍门 ， 并 为 这 些小 窍门 提供 一 定 的 解释 性 文档 。 本 书 汇 
聚 了 开发 与 众 不 同 的 Android 应 用 程序 所 需要 的 技巧 和 窍门 。 


我 喜欢 《Effective Java》 一 书 的 原因 是 ， 这 本 书 没有 特定 的 章节 顺序 ， 因 此 可 以 自由 学 习 不 同 章节 的 内 容 。 每 隔 一 段 时 间 ， 
当 回 顾 此 书 时 ， 我 总 能 为 当前 项 目 找 到 一 些 不 同 的 应 用 程序 。 在 写 这 本 书 的 时 候 ， 我 一 直 牢 记 一 个 信条 : 我 想象 读者 在 上 班 路 上 
或 者 睡觉 前 会 有 兴趣 学 习 本 书 里 的 某 个 Hack， 并 且 从 这 个 Hack 中 获得 对 当前 项 目 有 益 的 启发 。 


我 已 经 在 新 项 目 中 应 用 了 这 本 书 的 内 容 ， 我 会 在 特定 的 工作 任务 中 复 用 书 中 的 示例 代码 ， 使 用 示例 代码 向 同事 解释 特定 的 开 
发 模式 。 实 践 证 明 ， 本 书 对 我 是 十 分 有 用 的 ， 当 然 ， 我 也 布 望 这 本 书 对 你 同样 有 用 。 


撰写 本 书 以 及 书 中 的 示例 代码 时 ， 我 把 最 小 SDK 版 本 设置 为 1.6。 如 非特 别提 及 ， 本 书 中 多 数 技 巧 都 适用 于 Android 1.6 及 其 以 
上 版 本 。 你 会 注意 到 ， 有 一 些 技 巧 只 适用 于 最 新 版 本 的 Android, 但 是 多 数 建议 和 技巧 都 适用 于 所 有 版 本 。 每 个 Hack 都 提供 一 
图 标 ， 用 来 表示 这 个 Hack 适 用 的 最 低 SD 区 版本。 


那么 接 下 来 ， 你 就 从 本 书 的 目录 中 挑选 自己 感 兴趣 的 技巧 开始 学 习 吧 。 项 望 你 能 从 我 写 的 内 容 中 学 到 尽 可 能 多 的 知识 。 


致谢 


每 当 读 到 其 他 书 的 致谢 时 ， 我 总 会 惊讶 作者 感谢 的 人 竟然 如 此 之 多 。 现 在 终于 明白 为 什么 需要 感谢 这 么 多 人 ， 当 写 到 这 里 的 
时 候 ， 我 很 紧张 ， 生 怕 遗 漏 了 某 个 人 。 


首先 ， 我 要 感谢 的 是 编辑 Cynthia Kane， 好 帮助 我 加 工整 理 整 本 书 的 内 容 。 好 不 仅 指出 本 书 中 需要 修改 的 每 个 地 方 ， 还 处 理 
我 英语 语言 上 需要 润色 的 地 方 ， 并 且 帮 助 我 理解 图 书 出 版 过 程 中 的 每 个 关键 环节 。 修 订 每 一 行文 字 ， 修 改 好 发 现 的 每 一 个 不 足 之 
处 ， 通 过 这 个 反复 迁 代 的 修正 过 程 ， 终 于 完成 了 这 本 值得 我 骄傲 的 书 。 


其 次 应 该 感谢 Nicholas Chase，Nick 负 责 支 持 Manning 出 版 社 的 XML 文档 结构 和 创作 工具 。 幸 运 的 是 ， 每 当 我 有 问题 需要 请 教 
他 时 ， 他 的 Skype 总 是 在 线 。 


Manning 出 版 团队 的 其 他 成 员 也 参与 了 大 量 工 作 。 参 与 这 项 工作 的 有 Ozren Hatlovic、Kevin Sullivan, Tara McGoldrick Walsh, 


Benjamin Berg. Katie Tennant. Candace Gillhoolley, Martin Murtonen, Michael Stephens VA X Maureen Spencer, 


感谢 我 的 合 著者 : William Sanville (Hack 40 和 Hack 41) ~ Chris King (Hack 26) RA Christopher Orr (Hack 50) 。 他 们 分 享 
了 在 这 些 领 域 的 专业 知识 。 


感谢 Cyril Mottiert ， 他 深入 阅读 了 本 书 ， 并 且 毫 不 保留 地 指出 书 中 他 不 喜欢 或 者 认为 需要 改进 的 地 方 。 他 始终 对 本 书 保持 高 
要 求 ， 我 很 喜欢 跟 他 人 合作。 非常 感谢 ! 


感谢 我 在 NASA Trained Monkeys 公 司 的 合作 伙伴 们 。 他 们 帮助 我 审阅 了 书 中 大 部 分 内 容 ， 并 提出 很 多 建设 性 意见 。 大 部 分 很 
酷 的 Hack 标 题 都 来 源 于 他 们 丰富 的 想象 力 。 


感谢 Android 社 区 ， 特 别 感 谢 那 些 对 开源 软件 库 有 贡献 的 人 们 。 (这 里 只 提 及 几 个 人 的 名 字 ， 他 们 是 : Michael Burtons 
Manfred Moser. Matthias K.ppler、Jake Wharton, Jeremy Feinstein, cocos2d-xH]FA. Jan Berkel, Jeff Gilgelt、Xavi Rigau, Chris 


Banes, James Brechtel 和 Dmitry Skiba) 。 


感谢 审阅 本 书 的 每 一 个 人 。 你 们 的 审阅 意见 帮助 我 及 时 发 现 疏 汤 的 地 方 以 及 需要 强化 的 主题 。 从 我 襄 佩 的 人 那里 获得 正面 的 
评价 是 很 有 意义 的 事情 。 感 谢 以 下 审阅 者 ， 你 们 在 百 忙 之 中 审阅 本 书 ， 我 也 希望 这 本 书 对 你 们 有 一 些 启发 ， 这 些 人 是 : Adam 
Koch. Alberto Pose. Bill Cruise. Christian Badenas、 Frank Ableson、 Ignacio Luciani. Jeff Goldschrafe. Joshua Skinner. Matthias 
K.ppler. Maximiliano Gomez Vidal, “Ming? . Octavian Damiean, Paul Butcher. Robi Sen, Roger Binns, Shan Coster, Suzanne 
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给 予 我 巨大 的 支持 。 


最 后 要 感谢 Mili ， 你 的 工作 同样 重要 ， 每 当 我 需要 帮助 的 时 候 ， 你 总 是 在 我 身边 。 我 爱 你 。 


天 于 本 书 


Android 是 一 个 发 展 势头 很 好 的 项 目 。Android 的 第 一 个 正式 版 本 (Android 1.0) 发 布 于 2008 年 9 月 23 日 ， 堆 至 2010 年 年 
底 ，Android 已 经 发 展 成 为 首要 的 智能 手机 平台 


每 当 有 新 版 本 发 布 ，Android 都 会 引入 一 组 新 的 API 和 新 特性 。 尽 管 在 Android 1.5l1 的 时 期 ， 市场 上 只 有 HTC Dream 手 机 运行 
Android 系 统 ， 但 是 发 展 至 今 ，Android 系 统 不 仅 可 以 运行 在 从 手机 到 电视 等 多 种 设备 上 ， 还 可 以 运行 在 不 同 屏 幕 大 小 的 平板 电脑 
和 笔记 本 电脑 上 。 


上 述 情 况 给 Andtoid 开 发 者 带 来 了 两 个 不 小 的 难题 。 第 一 个 难题 是 开发 者 必须 面 对 和 适 配 Andtoid 支 持 的 不 同类 型 的 设备 。 虽 
然 有 很 多 方法 处 理 不 同 的 屏幕 尺寸 和 像素 密度 ,但 是 开发 者 必须 开发 出 能 够 运行 在 各 种 设备 上 并 且 显 示 正 常 的 应 用 。 另 外 ， 
对 各 种 Android 设 备 可 能 导致 的 用 户 体验 不 一 致 的 情况 做 出 处 理 。 用 户 对 手机 和 电视 的 使 用 习惯 是 不 同 的。 


第 二 个 难题 是 Android 的 版 本 更 新 间 题 。 这 个 难题 是 周而复始 的 : 使 用 新 版 本 的 Android 系 统 ， 意 味 着 开发 者 可 以 使 用 新 的 
API， 新 的 API 可 以 为 应 用 程序 增加 优秀 的 功能 ; 但 是 开发 者 必须 同时 支持 旧 的 Android 版 本 ， 因 为 并 不 是 每 个 用 户 都 会 升级 系 
统 ， 而 且 目 标 用 户 获取 和 认可 应 用 程序 也 需要 一 定时 间 。 


开发 者 需要 在 两 者 之 间 做 出 选择 : 要 么 使 用 新 的 API 功 能 并 发 布 一 个 特定 版 本 的 应 用 ， 满 足 那些 使 用 新 版 本 Android 系 统 的 用 


PG 要 么 采取 折 中 的 方法 ， 保 证 一 些 新 的 功能 只 适用 于 新 版 本 的 Andtoid 系 统 。 


上 述 选 择 最 终 都 由 Andtoid 开 发 者 决定 ， 因 此 我 写 这 本 书 的 目的 是 帮助 开发 者 解决 这 个 难题 。 本 书 以 “问题 /解决 方案 ”的 形 
式 提出 开发 过 程 中 遇 到 的 问题 并 给 出 其 解决 方法 ， 并 对 一 些 已 有 问题 提供 了 进一步 的 处 理 方案 。 


什么 是 Android 


Android 是 一 个 基于 Linux 内 核 的 开源 操作 系统 。 起 初 ，Andrtoid 只 支持 手机 设备 ,但 是 发 展 到 现在 ，Android 可 以 运行 于 平板 电 
脑 、 电 视 、 电 脑 甚至 汽车 音响 等 多 种 设备 。Android 在 移动 领域 赢得 了 巨大 的 发 展 空 间 ， 到 目前 为 止 ， 50% 以 上 的 移动 设备 运行 
了 Android 操 作 系 统 。 


运行 在 Android 操 作 系 统 上 的 应 用 通常 使 用 Java 语 言 开发 ，Android 提 供 了 一 个 强大 的 SDK (软件 开发 工具 包 ) 供 开 发 者 开发 
不 同类 型 的 应 用 程序 。Andtoid 允 许 开 发 者 定制 几乎 所 有 模块 ， 例 如 ， 开 发 者 可 以 开发 定制 的 墙纸 、 键 盘 、 桌 面 以 及 在 其 他 平台 
上 想 都 不 敢 想 的 功能 。 


ET! 


本 书 读者 对 象 


本 书 适用 于 已 经 学 习 过 Android 开 发 的 程序 员 ， 并 且 假 定 读者 已 经 熟悉 Java 编 程 语言 ， 并 理解 Android 平 台 的 基本 概念 。 


本 书 不 仅 提 供 适 用 于 Android 初 学 者 的 技巧 ， 还 提供 适用 于 高 级 开发 者 的 技巧 。 如 果 读 者 正在 开发 Android 应 用 程序 ， 我 相信 
通过 本 书 ， 你 可 以 学 到 很 多 有 帮助 的 知识 。 


通过 以 下 几 个 问题 ， 读 者 可 以 知道 本 书 是 否 适 合 自己 : 
: 你 是 一 个 Android 应 用 程序 开发 者 吗 ? 

. 你 正在 绞 尽 脑汁 思考 更 好 的 解决 方案 吗 ? 

你 正在 寻找 新 的 方法 解决 编程 中 出 现 的 问题 吗 ? 


- 你 想 知 道 其 他 人 是 如 何 解决 类 似 问 题 的 吗 ? 


如 何 使 用 本 书 


我 的 建议 是 : 在 读者 学 习 每 一 条 Hack 前 ， 先 编译 并 运行 示例 代码 ， 这 样 有 助 于 读者 更 好 地 理解 每 个 案例 。 此外， 读者 不 需 
要 按照 特定 顺序 学 习 本 书 ， 读 者 可 以 随时 跳 转 到 自己 感 兴趣 的 章节 开始 学 习 


本 书 结构 


虽然 读者 可 以 灵活 选择 自己 感 兴趣 的 部 分 学 习 ， 不 会 因为 前 后 章节 顺序 的 原因 出 现 阅读 困难 ， 但 是 读者 仍然 可 以 按 顺 序 阅 读 
本 书 。 各 章节 的 概要 内 容 如 下 : 


- 第 1 章 包含 4 个 Hack， 讲 解 布 局 相关 的 小 窍门 。 
第 2 章 包 含 4 个 Hack， 介 绍 动画 处 理 相 关 的 小 窍门 。 


第 3 草包 含 9 个 Hack， 涵盖 与 Yiew 相 关 的 小 窍门 。 


第 4 章 包 含 两 个 Hack， 概 括 除 IDE 以 外 的 可 用 工具 。 

- 第 5 章 包含 4 个 Hack， 提 供 适用 于 Andtoid 开 发 的 模式 示例 。 

- 第 6 章 包含 7 个 Hack， 提 供 一 组 适用 于 ListView 和 Adaptet 类 的 小 窍门 。 
第 7 章 包 含 两 个 Hack， 解 释 如 何在 应 用 中 使 用 第 三 方 库 。 


| 第 8 草包 含 两 个 Hack， 通 过 一 些 例子 ， 解 释 如 何 用 Java 以 外 的 编程 语言 为 Android 编 写 程序 。 其 中 一 个 Hack 分 析 如 何 与 
Objective-C 语 言 交互 ， 另 一 个 Hack 分 析 如 何 与 Scala 语 言 交 互 。 


- 第 9 和 草包 含 6 个 Hack， 提 供 一 些 可 以 复 用 的 代码 片段 。 
- 第 10 章 包含 3 个 Hack， 展 示 一 些 使 用 数据 库 的 高 级 技巧 。 
第 11 章 包含 4 个 Hack， 展 示 如 何 令 应 用 程序 运行 在 不 同 的 Android 版 本 上 。 


- 第 12 章 通过 最 后 3 个 技巧 提供 如 何 构建 应 用 的 小 窍门 。 


代码 规 沁 和 下 载 
本 书 所 有 示例 代码 都 以 monospace 字 体 显示 。 注 释 直 接 写 在 代码 中 ， 对 于 较 长 的 注释 ， 使 用 数字 编号 标识 。 


本 书 所 有 示例 代码 都 可 以 从 出 版 社 网 站 下 载 ， 出 版 社 网 BE X www.manning.com/50AndroidHacks'"l 。 读 者 也 可 以 从 Google 公 司 
的 code 项 目 中 下 载 源 代 码 ， 下 载 最 新 示例 代码 的 方法 列 在 附录 中 。 此 外 ， 示 例 代 码 托 管 在 GitHub 中 ， 读 者 还 可 以 
从 https://github.com/Macarse/50AH-code 下 载 。 


如 果 要 运行 本 书 的 示例 代码 ， 读 者 需要 安装 以 下 工具 : 

: Eclipse 

- Android SDK 

: Eclipse Android4& fF 

如 果 读 者 不 知道 如 何 安装 ， 我 建议 首先 访问 http://developer.android.com/sdk/installing/index.html， 这 里 提供 了 配置 开发 环境 


$4 fe 简 单 步 又 m 


作者 在 线 支 持 


Manning 出 版 社 运营 的 网 上 论坛 为 本 书 提供 免费 的 在 线 支持 。 读 者 可 以 通过 该 论坛 发 表 关 于 本 书 的 意见 和 建议 ， 也 可 以 提问 
技术 问题 ， 还 可 以 从 作者 和 其 他 读者 处 得 到 帮助 和 和 支持。 访问 和 订阅 该 论坛 的 方法 很 简单 ， 读 者 只 需要 在 浏览 器 中 输入 以 下 网 
址 : www.manning.com/50AnroidHacks。 这 个 网 页 提供 了 论坛 注册 后 的 注意 事项 、 读 者 服务 以 及 论坛 规则 等 信息 。 


Manning 出 版 社 对 读者 的 承诺 是 : 提供 一 个 在 读者 和 读者 之 间 ， 以 及 读者 和 作者 之 间 可 以 产生 良好 互动 的 交流 场所 。 出 版 社 
不 能 保证 作者 有 充足 的 时 间 与 读者 互动 ， 因 为 作者 完全 是 自愿 且 免 费 为 论坛 服务 的 。 我 们 建议 读者 多 向 作者 提问 一 些 有 挑战 的 
问题 ， 以 激发 作者 答疑 的 兴趣 。 


本 书 出 版 后 ， 读 者 可 以 从 出 版 社 的 网 站 访问 作者 在 线 支持 论坛 查看 已 有 的 讨论 帖 。 


天 于 作者 


Carlos Sessa 不 仅 是 一 位 充满 激情 的 全 职 Andtoid 开 发 者 ， 同 时 ， 他 也 是 一 家 移动 开发 公司 的 创始 人 人， 公司 名 称 为 NASA Trained 
Monkeys， 位 于 阿根廷 的 布 宜 诺 斯 艾 利 斯 。 他 的 公司 专注 于 为 Andtoid 和 iOS 等 移动 开发 平台 提供 解决 方案 。 





[1] 代号 Cupcake， 纸 杯 有 蛋糕 。 译 者 注 


2 截止 本 书 翻译 时 ， 该 网 址 已 经 更 改 为 http://www.manning.com/sessa/。 





译 者 注 


天 于 原 书 封面 插图 


本 书 英文 版 封面 插图 中 的 人 物 是 一 个 椎 夫 。 这 幅 插 图 取 自 Sylvain Maréchal 所 著 的 四 卷 《 区 域 服饰 习俗 概要 》， 该 书 于 19 世 纪 
在 法 国 出 版 。 书 中 每 幅 播 图 都 经 过 精心 绘制 和 手工 着 色 。 通 过 大 量 丰 富 多 彩 的 图 片 ，Matechal 向 我 们 生动 地 展示 了 如 何 从 文化 上 
区 分 200 年 前 世界 上 不 同 的 城镇 和 地 区 。 由 于 彼此 隔绝 ， 不 同 地 区 的 人 们 说 着 不 同 的 方言 和 语言 。 无 论 是 在 街道 还 是 在 乡间 ， 我 
们 可 以 仅仅 根据 服饰 区 分 出 人 们 生活 的 区 域 、 职 业 以 及 状况 。 


此 后 ， 着 装 要 求 和 区 域 服 饰 的 多 样 化 发 生 了 变化 ， 当 时 丰富 多 彩 的 服饰 也 逐渐 消失 。 现 在 已 经 很 难 区 分 不 同 大 陆 的 居民 ， 就 
更 不 用 说 区 分 不 同 的 城镇 和 地 区 的 居民 了 。 或 许 ， 我 们 以 文化 的 多 样 性 为 代价 换 来 了 丰富 多 彩 的 个 人 生活 ， 当 然 ， 换 来 的 是 更 多 
样 、 更 快 节奏 的 科技 生活 。 


当 计 算 机 书籍 千篇一律 ， 读 者 很 难 一 次 就 区 分 出 不 同 的 计算 机 书籍 的 时 候 ，Manning 出 版 社 赞赏 计算 机 业务 部 门 通过 图 书 封 
面 呈现 多 样 性 的 创造 思 


多 样 性 。 


维和 主动 性 ， 术 书 便 以 Maréchal 描 绘 的 两 个 世纪 前 不 同 区 域 的 丰富 多 彩 和 活灵活现 的 生活 写照 来 体现 这 种 


第 1 章 “活用 布局 


本 章 将 介绍 Android 布 局 相 天 的 一 些 穷 门 和 建议 。 通 过 本 章 ， 读 者 不 仅 可 以 学 习 如 何 从 零 开 始 创建 特定 类 型 的 布局 ， 还 可 以 
学 到 如 何 改进 和 优化 现 有 布局 。 


Hack 1 使 用 weight 属 性 实现 视图 的 居中 显示 
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在 给 开 友 者 做 演讲 时 ， 当 我 解释 如 何 通 过 XML 文 件 创建 视图 的 时 候 ， 一 个 开 友 者 问 道 : “如 果 我 想 将 按钮 居中 显示 ， 并 且 
占据 其 父 视图 宽度 的 一 半 ， 应 该 怎么 做 呢 ? ”起 急 ， 我 并 没有 完全 理解 他 的 意思 ， 后 来 他 把 想 要 实现 的 功能 男 在 了 黑板 上 ， 我 才 


DAAE. fUASSCHIBSDISERDE- T$UÉEd]1-2B zn. 


看 起 来 很 简单 是 吗 ? 现在 开始 ， 请 读者 用 5 分 钟 时 间 实 现 这 个 功能 。 在 这 个 Hack 里 ,我 们 分 析 如 何 结合 LinearLayout 的 
android: weightSum 属 性 和 LinearLayout 的 子 视图 的 android: layout weight 属 性 来 解决 这 个 问题 。 这 听 起 来 似乎 很 简单 ， 
不 过 我 经 单 在 面试 中 问 到 这 个 问题 ， 很 少 有 面试 者 知道 最 佳 答案 。 


ü 中 


Hackü0 1 








Glick me 

















图 1-1 居中 显示 按钮 ， 并 占据 父 视图 50% 宽 度 ( 竖 屏 ) 
z nll © 11:14PM 


Hack00 1 


Click ma 





H1-2 ”居中 显示 按钮 ， 并 占据 父 视图 50% 宽 度 〈 横 屏 ) 


1.1 合用 weightSum 属 性 和 layout weight 属 性 


不 同 Android 设 备 的 尺寸 往往 是 不 同 的 。 作 为 开 友 者 ， 我 们 需要 创建 适用 于 不 同 尺 寸 屏幕 的 XML 文 件 。 硬 编码 是 不 可 取 的 ， 
因此 需要 其 他 方法 来 组 织 视图 。 


本 忆 分 析 如 何 合用 layout_weight 和 weightSum 这 两 个 属性 来 填充 布局 内 部 的 任意 剩余 空间 。android: weightSum ( 见 
1.3135) 的 开 上 友 文 档 里 的 一 段 摘 述 与 我 们 现在 想 要 实现 的 功能 类 似 ， 文 档 内 容 如 下 : 


“定义 weight 总 和 的 最 大 值 。 如 果 未 指定 该 值 ， 以 所 有 子 视图 的 layout_weight 属 性 的 累加 值 作为 总 和 的 最 大 值 。 一 个 典型 的 
案例 是 : 通过 指定 子 视图 的 layout_weight 属 性 为 0.5， 并 设置 LinearLayout 的 weightSum 属 性 为 1.0， 实 现 子 视图 占据 可 用 宽度 的 


» 


50% 2 


设想 一 个 场景 : 我 们 要 在 盒子 里 放置 其 他 物体 。 盒 子 可 用 空间 的 比例 残 是 weightSum ， 盒 子 中 每 个 物体 可 用 空间 的 比例 融 
是 layout weight。 例 如 ， 盒 子 的 Weightsum 是 1， 我 们 需要 往 盒子 里 放置 两 个 物体 : 物体 A 和 物体 B。 物 体 A 的 layout_ weight 
为 0.25， 物 体 B 的 layout_weight 为 0.75。 那 么 ， 物 体 A 可 以 占据 盒子 25% 的 空间 ， 而 物体 B 可 以 占据 剩 下 的 75% 的 空间 。 


本 草 开 头 所 讨论 问题 的 解决 方案 是 与 之 类 似 的。 我 们 为 父 视图 指定 一 个 weightSum， 然 后 指定 Button 的 android: 
layout_weight 属 性 为 weightSum 的 一 半 。XML 文 件 的 源码 如 下 所 示 : 


«?xml version-"1.0" encoding-"'utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 

android:layout height-"fill parent" 

android:background-"£FFFFFF" 

android:gravity-"'center" 


android:orientation-"horizontal" p EL 
android:weightSum-"1"» q 
p 9 指定 按钮 宽度 
android:layout width-"Odp" < 
android:layout height-2"wrap content" 
android:layout, weight-'0.5" «— 确保 按钮 占据 50% 可 用 
android:text-"Click me"/-» 2x pr] 
es EF 


</LinearLayout> 


EOOH, faxELinearLayoutfljJandroid: weightSum 属 性 值 为 1， 表 示 其 内 部 所 有 子 视图 的 weight 比 例 总 和 是 1。 
LinearLayout 只 有 唯一 一 个 子 视图 : Button 控 件 。 在 中 ， 指 定 Button 的 android: layout width 属 性 值 为 0dp， 因 此 需要 根 
据 android: weight-Sum 属 性 决定 Button 的 width。 在 G@ 中 ， 指 定 Button 的 android: layout weight 属 性 值 为 0.5， 最 终 
Button 将 占据 50% 的 可 用 空间 。 


Bt F2KLA9873200dp, android: weightSsum 属 性 值 为 1 的 Linear-Layout 为 例 分析 上 述 过 程 。 计 算 Button 宽 度 的 公式 如 


F: 
Button's width + Button's weight * 200 / sum(weight) 
因为 指定 Button 的 宽度 为 0dp，Button 的 weight 为 0.5，sum (weight) 等 于 1， 所 以 结果 如 下 : 
Ü + 0.5 * 200 / 1 = 100 
1.2 ”概要 


当 开 发 者 需要 根据 比例 分 配 布局 可 用 空间 的 时 候 ， 使 用 LinearLayout 的 weight 属 性 是 很 有 必要 的 ， 这 避免 了 使 用 硬 编码 的 
方式 带 来 的 副作用 。 如 果 目 标 平台 是 Honeycomb 并 且 使 用 Fragment， 读 者 会 发 现 绝 大 多 数 案例 中 都 是 使 用 weight 在 布局 文件 
中 为 Fragment 分 配 空间 。 深 入 理解 如 何 使 用 weight 会 为 读者 增添 一 项 重要 技能 。 


1.3 ”外 部 链接 


http:;//developer.android.com/reference/android/widget/LinearLayout.html 


Hack2 ”使 用 延迟 加 载 以 及 避免 代码 重复 
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当 创建 复杂 的 布局 时 ， 开 有 友 者 可 能 会 友 现 添加 了 很 多 View-Group 和 View 控 件 。 随 之 而 来 的 问题 是 View 树 的 层次 越 来 越 
深 ， 应 用 程序 也 赵 来 越 慢 。 优 化 布局 是 创建 运行 速度 快 ， 啊 应 灵敏 的 应 用 程序 的 基础 。 


在 这 个 Hack 里 ， 读 者 会 学 到 如 何在 XML 文件 中 使 用 <include/ > 标签 来 避免 代码 的 重复 以 及 如 何 使 用 ViewSstub 类 实现 视 医 
的 延迟 加 载 。 


2.1 使 用 <include/> 标 签 避免 代码 重复 


设想 一 种 情况 : 我 们 需要 为 应 用 程序 中 的 每 个 视图 都 添加 一 个 页 脚 。 为 了 简化 问题 ， 我 们 假设 页 脚 是 一 个 显示 应 用 程序 名 的 
TextView。 通 单 多 个 Activity 会 对 应 多 个 XML 文件 。 难 道 我 们 需要 把 这 个 TextView 复 制 到 每 个 XML 文件 中 吗 ” 如 果 以 后 需要 修 
改 这 个 TextView 会 出 现 什 么 情况 ?”“ 复 制 /粘贴 ”的 方式 固然 能 够 解决 这 个 问题 ， 但 并 不 是 高 效 的 万 法。 解决 上 述 问 题 的 最 简单 
万 法 是 使 用 <include/> 标 签 。 接 下 来 分 析 该 标签 是 如 何 解 决 这 个 难题 的 。 


我 们 可 以 通过 <include/> 标 签 把 在 其 他 XML 文 件 中 定义 的 布局 插入 当前 布局 文件 中 。 在 本 节 的 示例 代码 里 ， 我 们 将 创建 一 
个 完整 的 视图 布局 文件 ， 在 该 文件 最 后 的 位 置 ， 使 用 <include/ > 标签 插入 页 脚 布 局 。 以 其 中 一 个 Activity 为 例 ， 其 XML 布局 文件 
如 下 所 示 : 


<RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent"> 


«TextView 
android:layout width-2-"fill parent" 
android:layout height-"wrap content" 
android:layout centerInParent-"true" 
android:gravity-"center horizontal" 
android:text-"Gstring/hello"/» 


«include layout-"Glayout/footer with layout properties"/» 


«/RelativeLayout/»2 


footer with layout properties 布 局 文件 如 下 所 示 : 


«TextView xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-2"wrap content" 
android:layout alignParentBottom-"true" 
android:layout marginBottom-"30dp" 
android:gravity-"center horizontal" 
android:text-"Gstring/footer text"/» 


在 上 述 示例 代码 中 ， 我 们 使 用 了 <include/> 标 签 ， 并 且 只 需要 指定 该 标签 的 layout 属 性 值 。 读 者 可 能 会 根 : “这 种 方式 之 
所 以 可 行 是 因为 Activity 在 main 布 局 文件 中 使 用 的 是 RelativeLayout。 如 果 其 中 一 个 Activity 的 布局 文件 使 用 的 是 LinearLayout 
Je? android: layout alignParentBottom= "true "适用 于 RelativeLayout， 但 是 并 不 适用 于 LinearLayout。 ”这 个 想法 是 
正确 的 。 接 下 来 分 析 使 用 <include/> 标 签 的 第 二 种 方法 ， 在 这 种 方法 里 ,我 们 直接 在 <include/ > 标签 里 使 用 android: 
layout * 属 性 。 


以 下 是 修改 后 的 main.xml 文 件 ， 其 中 使 用 了 <include/ > 标签 的 android: layout_* 属 性 ,源码 如 下 所 示 : 


«RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent"-» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout centerInParent-"true" 
android:gravity-"center horizontal" 
android:text-"Gstring/hello"/» 


«include 
layout-"GQlayout/footer" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:layout marginBottom-"30dp"/» 


«/RelativeLayout/» 


修改 后 的 页 脚 布局 文件 如 下 : 


«TextView xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"Odp" 
android:layout height-"Odp" 
android:gravity-"center" 
android:text-"Gstring/footer text"/» 


在 第 二 种 方法 中 ， 我 们 通过 <include/> 标 签 指定 页 脚 的 位 置 。Android 的 缺陷 (Issue) E iny 
陷 的 标题 是 : “<include/> 标 签 失效 了 ， 如 果 想 通过 <include/> 标 签 的 属性 覆盖 被 包含 的 布局 所 指定 的 属性 是 行 不 通 的 。 


这 个 issue 摘 述 的 问题 在 一 定 程度 上 是 正确 的 ， 问 题 出 在 如 果 想 在 <include/ > 标签 中 履 盖 被 包含 布局 所 指定 的 任何 android: 
layout * 属 性 ， 必 须 在 <include/ > 标签 中 同时 指定 android: layout width 和 android: layout height 这 两 个 属性 。 


在 这 个 Hack 中 ， 读 者 有 没有 注意 到 一 个 小 细节 ? 在 第 二 个 示例 程序 中 ， 我 们 把 所 有 android: layout * 属 性 都 移 到 
<include/> 标 签 中 了 ， 而 footer.xml 文 件 中 的 layout width 和 layout height 属 性 都 指定 为 0dp。 这 人 么 做 的 目的 是 由 footer.xml 
文件 的 使 用 者 在 <include/> 标 签 中 指定 layout_width 和 layout_height 属 性 。 如 果 使 用 者 不 指定 这 两 个 属性 ， 它 们 的 默认 值 都 是 
0， 我 们 便 看 不 到 页 脚 。 


[1] Issue 原 始 地 址 位 于 http://code.google.com/p/android/issues/detail?id 二 28063。 





译 者 注 


2.2 通过 ViewqStub 实 现 View 的 延迟 加 载 

设计 布局 的 时 候 ， 读 者 可 能 想 过 根据 上 下 文 或 者 用 户 交 互 情 况 显示 一 个 视图 。 如 果 想 要 一 个 视图 只 在 需要 的 时 候 显示 ， 请 继 
续 往 下 阅读 ， 你 会 党 试 使 用 ViewStub 这 个 类 。 

Android 开 发 文档 中 有 关于 ViewStub 的 介绍 (参照 2.4 节 ) ， 主 要 内 容 如 下 : 


ViewStub 是 一 种 不 可 视 并 且 大 小 为 0 的 视图 ， 可 以 延迟 到 运行 时 填充 (inflate) 布局 资源 。 当 ViewStub 设 置 为 可 视 或 者 
inflate () 方法 被 调用 后 ， 就 会 填充 布局 资源 ， 然 后 ViewStub 便 会 被 填充 的 视图 替代 。 C 


既然 已 经 清楚 ViewStub 是 什么 ， 接 下 来 看 看 它 能 做 什么 。 在 下 面 的 示例 代码 中 ， 我们 使 用 ViewStub 来 延迟 加 载 一 个 
MapView。 假 设 需要 创建 一 个 视图 来 显示 地 理 位 置 的 详细 信息 ， 先 看 两 种 可 能 情况 : 


:一些 场所 没有 GPS 信息 
:用户 可 能 并 不 需要 地 图 信息 


如 果 一 个 场所 没有 GPS 信息 ， 开 发 者 不 需要 在 地 图 上 显示 标记 信息 。 同 样 ， 如 果 用 户 不 需要 地 图 信息 ， 也 就 无 须 加 载 地 图 。 
我 们 可 以 把 MapView 放 置 在 Viewstub 标 签 中 ， 让 用 户 自 己 决定 是 否 显示 地 图 信息 。 


要 达到 上 还 目的 ， 需 要 使 用 下 面 的 布局 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill. parent" 
android:layout height-"fill parent"> 


«Button 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Gstring/show map" 
android:onClick-"onShowMap"/-2 


«ViewStub 
android:id-"G«id/map stub" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layoutz-"Glayout/map" 
android:inflatedId-"QG«id/map view"/» 
«/RelativeLayout» 


很 显然 ， 需 要 通过 map_ stub 这 个 ID 从 Activity 中 获取 ViewSstub。 同 时 ， 以 android: layout 属 性 指定 需要 填充 的 布局 文 
件 。 对 于 本 例 ， 需 要 填充 的 布局 文件 是 map.xml 文 件 ， 源 人 码 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
«com.google.android.maps.MapView 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:clickable-"true" 
android:apiKey-"my api key"/» 


最 后 一 个 需要 说 明 的 属性 是 inflatedld。inflatedld 是 调用 ViewStub 的 inflate () 方法 或 者 setVisibility () 方法 时 返回 的 
ID， 这 个 1D 便 是 被 填充 的 View 的 ID。 在 本 例 中 ， 我们 不 需要 操作 MapView， 只 需要 调用 setVisibility (View.VISIBLE) 方法 即 
可 。 如 果 想 获取 被 填充 的 视图 的 引用 ，inflate () 方法 会 直接 返回 该 引用 ， 这 样 避 免 了 再 次 调用 findViewByld () 方法 。 


Activity 的 源码 比较 简单 ， 如 下 所 示 : 


public class MainActivity extends MapActivity { 
private View mViewStub; 


QOverride 

public void onCreate (Bundle savedlInstanceState) ( 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
mViewStub = findaViewById(R.id.map stub); 


public void onShowMap(View v) { 
mViewStub.setVisibility(View.VISIBLE); 


如 上 述 代码 所 示 ， 只 需要 改变 ViewStub 的 可 视 性 便 可 控制 map 的 显示 。 


2.3 WE 
<include/> 标 签 是 整理 布局 的 有 效 工 具 。 如 果 读 者 使 用 过 Fragment， 会 发 现 它 与 <include/> 标 签 的 使 用 方法 几乎 是 相同 
的 。 就 像 使 用 Fragment 一 样 ， 完 整 的 视图 可 以 由 一 系列 <include/ > 标签 组 成 。 


<include/ > 标签 提 供 了 合理 组 织 XML 布 局 文件 的 有 效 方 法 。 如 果 读 者 正在 创建 一 个 复杂 的 布局 或 者 布局 文件 变 得 很 大 ， 那 
么 可 以 试 试 创建 不 同 的 布局 片段 ， 然 后 通过 <include/> 标 签 将 这 些 片 段 组 合 起 来 。 这 样 XML 布 局 文件 就 会 变 得 更 清晰 更 易 组 
Zr1 


-/ No 


Viewstub 是 实现 延迟 加 载 视 图 的 优秀 类 。 无 论 企 什么 情况 下 ， 只 要 开 妈 者 需要 根据 上 下 文选 择 隐 藏 或 者 显示 一 个 视图 ， 都 
可 以 用 Viewstub 实 现 。 或 许 并 不 会 因为 一 个 视图 的 延迟 加 载 而 感 吕 到 性 能 的 明显 提升 ， 但 是 如 果 视 图 树 的 层次 很 深 ， 便 会 感觉 
到 性 能 上 的 差距 了 。 


24 外 部/ 链接 


http://code.google.com/p/android/issues/detail?id 2 2863 
http:;//android-developers.blogspot.com.ar/2009/03/android-layout-tricks-3-optimize-with.html 


http:;//developer.android.com/reference/android/view/ViewStub.html 
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当 设 计 应 用 程序 时 ， 开 妈 者 可 能 需要 企 不 同 的 Activity 中 显示 复杂 的 视图 。 假 设 读者 正在 开 友 一 天 扑克 牌 游戏 ， 需 要 创建 类 
似 图 3-1 的 布局 来 显示 玩家 的 手 牌 。 应 该 如 何 创建 这 样 的 布局 呢 ? 





图 3-1 扑克 牌 游 戏 中 的 玩家 手 牌 


或 计 读 者 会 说 ， 使 用 margin 属 性 便 足 以 实现 这 种 布局 。 管 案 是 正确 的 ， 开 友 者 可 以 使 用 RelativeLayout 布 局 管理 器 ， 然 后 
为 其 内 部 View 控 件 指定 margin 属 性 值 ， 这 样 便 可 以 实现 类 似 上 图 的 的 功能 ，XML 布 局 文件 源码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?-» 

«RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" > 


«View 
android:layout width-2"100dp" 
android:layout height-"150dp" 
android:background-"£FF0000" /> 


«View 
android:layout width-"100dp" 
android:layout height-"150dp" 
android:layout marginLeft-"30dp" 
android:layout marginTop-"20dp" 
android:background-"£00FF00" /> 


«View 
android:layout width-"100Gdp" 
android:layout height-"150dp" 
android:layout marginLeft-"60dp" 
android:layout marginTop-"40dp" 
android:background-"£$0000FF" /> 


«/RelativeLayout» 
«/FrameLayout» 


上 述 布局 的 显示 效果 如 图 3-2 所 示 。 


在 这 个 Hack 里 ， 我 们 分 析 实 现 上 述 功 能 的 另 一 种 方法 : 创建 自 定 义 ViewGroup。 访 方法 相对 于 在 XML 文件 中 手工 指定 
margin 值 有 如 下 优点 : 


: 在 不 同 Activity 中 复 用 该 视图 时 ， 更 易 维护 。 
- 开发 者 可 以 使 用 自 定义 属性 来 定制 ViewGfroup 中 子 视 图 的 位 置 。 
“ 布局 文件 更 简明 ， 更 容易 理解 。 


:如果 需要 修改 matgin， 不 必 重 新 手动 计算 每 个 子 视 图 的 matgin。 


are 0e 





图 3-2 ”使 用 Andtoid 默 认 控 件 创 建 的 玩家 手 牌 


接 下 来 首先 看 看 Android 是 如 何 绘制 视图 的 。 





3.1 理解 Android 绘 制 视图 的 方式 


在 创建 自 定 义 ViewGroup 前 ， 读 者 首先 需要 理解 Android 绘 制 视图 的 方式 。 我 不 会 涉及 过 多 细节 ， 但 是 需要 读者 理解 
Android 开 友 文 档 (113.555) 中 的 一 段 话 ， 这 段 话 解释 如 何 绘制 一 个 布局 。 内 容 如 下 : 


“绘制 布局 由 两 个 遍历 过 程 组 成 : 测量 过 程 和 布局 过 程 。 测 量 过 程 由 measute (int, int) 方法 完成 ， 该 方法 从 上 到 下 人 遍历 视 
图 树 。 在 递归 人 遍历 过 程 中 ， 每 个 视图 都 会 向 下 层 传递 尺寸 和 规格 。 当 measure 方 法 遍历 结束 ， 每 个 视图 都 保存 了 各 自 的 尺寸 信 
息 。 第 二 个 过 程 由 layout (int, int, int, int) 方法 完成 ， 该 方法 也 是 由 上 而 下 遍历 视图 树 ， 在 遍历 过 程 中 ， 每 个 父 视 图 通过 测量 

过 程 的 结果 定位 所 有 子 视图 的 位 置信 息 。 


为 了 理解 这 个 概念 ， 下 面 VPN 会 制 过 程 。 第 一 步 是 测量 ViewGroup 的 宽度 和 高 度 ， 在 onMeasure () 方法 中 
完成 这 步 操 作 。 在 该 方法 中 ，ViewGroup 通 过 遍历 所 有 子 视图 计算 出 它 的 大 小 。 最 后 一 步 操作 ， 在 onLayout () 方法 中 完成 ， 
在 该 方法 中 ， ee A RUE. 布局 所 有 子 视图 。 


3.2 ”创建 CascadeLayout 


本 节 开 始 为 自 定义 ViewGroup 编 码 。 读 者 会 看 到 与 图 3-2 一 样 的 结果 。 将 自 定 义 ViewGroup 命 名 为 CascadeLayout。 
CascadeLayout 使 用 的 XML 布 局 文件 如 下 所 示 : 


«?xml version-"1.0" encoding="utf-8"?> 

«FrameLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:cascade- 
"http://schemas.android.com/apk/res/com.manning.androidhacks.hack003" 
android:layout, width-"fill parent" «| dE XML 中 
android:layout, height-"fill parent" > Re E 

使 用 日 定义 


属性 时 指定 


«com.manning.androidhacks.hack003.view.CascadeLayout 


通过 cascade android: layout width-"fill parent" FLUE OC fi 
& Zl. android:layout height-"fill. parent" Z3 间 
你 就 可 以 使 一 cascade:horizontal spacing-"30dp" 在 XML 中 使 用 
用 其 自 定义 cascade:vertical, spacing-"20dp" > CascadeLayout 
属性 «View 布局 ， 需 要 指定 
android:layout width-"100dp" 完全 限定 类 名 


android:layout, height-"150dp" 
android:background-"£4FF0000" /> 


«View 
android:layout width-"100Gdp" 
android:layout, height-"150dp" 
android:background-"£00FF00" /> 


«View 
android:layout, width-"100dp" 
android:layout, height-"150dp" 
android:background-"£0000FF" /> 
«/com.manning.androidhacks.hack003.view.CascadeLayout» 


«/FrameLayout-» 


现在 读者 已 经 理解 需要 创建 什么 功能 ， 接 下 来 我 们 就 正式 开始 了 。 我 们 要 做 的 第 一 件 事 是 定义 那些 定制 的 属性 。 为 此 ， 需 


在 res 人 /values 目 录 下 创建 一 个 属性 文件 attrs.xml， 该 文件 的 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?-» 
«resources» 
«declare-styleable name-"CascadeLayout"-» 
«attr name-"horizontal spacing" format-"dimension" /> 
«attr name-"vertical spacing" format-"dimension" /» 
«/declare-styleable» 
«/resources» 


同时 还 需要 指定 水 平 间距 和 垂直 间距 的 默认 值 ， 以 便 在 未 指定 这 些 值 时 使 用 。 把 这 些 默 认 值 保存 在 dimens.xml 文 件 中 ， 该 
文件 同样 位 于 res/values 文 件 夹 下 。dimens.xml 文 件 的 内 容 如 下 : 


«?xml version-"1.0" encoding="utf-8"?> 


«resources» 
«dimen name-"cascade horizontal spacing"»10dp«/dimen» 


«dimen name-"cascade vertical spacing"»10dp«/dimen» 


-/resources» 


理解 了 Android 如 何 绘制 View 之 后 ， 读 者 可 能 会 想到 实现 一 个 继承 自 ViewGroup 的 CascadeLayout 类 ， 然 后 在 
CascadeLayout 类 中 重 写 ViewGroup 的 onMeasure () 和 onLayout () 方法 。 接 下 来 的 代码 有 点 长 ,我 们 分 成 三 部 分 内 容 分 
别 予以 分 析 。 这 三 部 分 是 : 构造 函数 、onMeasure () 方法 和 onLayout () 方法 。 先 看 构造 函数 ， 代 码 如 下 : 


public class CascadeLayout extends ViewGroup { 


private int mHorizontalSpacing; 
private int mVerticalSpacing; 


public CascadeLayout(Context context, AttributeSet attrs) ( 


super (context, attrs); 





mHorizontalSpacing 
TypedArray a = context.obtainStyledAttributes(attrs, fll mVerticalSpacing 
R.styleable.CascadeLayout); 
Hi A xE X Ja TE rn aX 
当 通 过 XML try CO ， | | €—— 取 ， 如 来 其 值 未 指 
、 mHorizontaliSpacing = a.getDimensionPixeiSize ME. — dh Ms 
文件 创建 该 | | 定 ， 就 使 用 默认 值 
况 图 的 实例 R.styleable.CascadeLayout, horizontal spacing, 
fe HI HJ ART getResources().getDimensionPixelSize( 
时 会 调用 该 R.dimen.cascade horizontal. spacing)); 
Ks Yi p , , , , , , 
构造 函数 mVerticalSpacing = a.getDimensionPixelSize( 
R.styleable.CascadeLayout, vertical, spacing, 
getResources(í) 
.getDimensionPixelSize( 
R.dimen.cascade vertical spacing)); 
} finally { 
a.recycle(); 
} 


在 编写 onMeasure () 方法 之 前 ， 先 创建 自 定义 LayoutParams 类 ， 该 类 用 于 保存 每 个 子 视图 的 x、y 轴 位 置 。 把 
LayoutParams 定 义 为 CascadeLayout 的 内 部 类 ， 该 类 的 定义 如 下 : 


public static class LayoutParams extends ViewGroup.LayoutParams { 
int we 
int v; 
public LayoutParams(Context context, AttributeSet attrs) { 


super(context, attrs); 


) 


public LayoutParams(int w, int h) ( 
super(w, h); 


要 使 用 新 定义 的 CascadeLayout.LayoutParams 类 ， 还 需要 重 写 CascadeLayout 类 中 的 其 他 一 些 广 法。 这 些 方法 是 
checkLayout-Params () 、generateDefaultLayoutParams () 、generateLayoutPar ams (AttributeSetattrs) 和 
generateLayoutParams (ViewGroup.LayoutParams p) 。 这 些 方法 的 代码 在 不 同 ViewGroup 之 间 往 往 是 相同 的 。 如 果 读 者 
对 这 些 方法 的 具体 内 容 感 兴趣 ， 可 以 在 示例 代码 中 找到 这 些 内 容 。 


一 步 是 对 onMeasure () 方法 编码 。 这 是 该 类 的 核心 部 分 。 代 码 如 下 所 示 : 


QOverride 

protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 
int width = 0; E 
int height - getPaddingTop(); 使 用 宽 和 高 计算 布局 





AN. 全 个 ] E a 
RE^] final int count = getChildCount(); I] dpc 2 A] VAR ^R 
了 于 视图 for (int i = 0; i < count; i++) ( 图 的 x 与 y 轴 位 置 
测量 E View child = getChildaAt(i); 
H >  measureChild(child, widthMeasureSpec, heightMeasureSpec); 
LayoutParams lp - (LayoutParams) child.getLayoutParams(); 
width = getPaddingLeft() + mHorizontalSpacing * i; 
lp.x - width; < 在 LayoutParams 
lp.y = height; 中 保存 每 个 子 视 
width += child.getMeasuredWidth(); 图 的 x 和 yy 坐标 
height += mVerticalSpacing; 
使 用 计算 } 
. 7 h ce 
所 得 的 宽 width += getPaddingRight(); 
Tg ix B height += getChildAt(getChildCount() - 1).getMeasuredHeight() 
救 个 布局 + getPaddingBottom(); 
Hj 测量 L> setMeasuredDimension(resolveSize (width, widthMeasureSpec), 
尺寸 resolveSize(height, heightMeasureSpec)); 


最 后 一 步 是 对 onLayout () 方法 编码 ， 代 码 如 下 所 示 : 


QGOverride 
protected void onLayout(boolean changed, int 1, int t, int r, int b) ( 


final int count = getChildCount(); 


for (int i = 0; i < count; i++) ( 
View child = getChildAt(i); 
LayoutParams lp - (LayoutParams) child.getLayoutParams(); 
child.layout(lp.x, lp.y, lp.x + child.getMeasuredWidth(), lp.y 


+ child.getMeasuredHeight()); 


由 以 上 代码 可 知 ， 代 码 逻 辑 是 非常 简单 的 。 该 方法 以 onMeasure () 方法 计算 出 的 值 为 参数 循环 调用 子 View 的 layout () 
方法 。 


3.3 ”为 子 视图 ;未 加 目 定 义 属 性 


在 最 后 一 节 ， 学 习 如 何 为 子 视图 添加 目 定义 属性 。 作 为 示例 ， 下 面 将 添加 为 特定 子 视 图 重 写 (override) 垂直 间距 的 方法 。 
读者 可 以 看 到 图 3-3 所 示 结 果 。 


第 一 步 是 向 attrs.xml 文 件 中 添加 一 个 新 的 属性 ， 代 码 如 下 ; 


<declare-styleable name="CascadeLayout LayoutParams"» 
<attr name-"layout vertical spacing" format-"dimension" /> 
«/declare-styleable» 


因为 属性 名 的 前 缀 是 layout_， 没 有 包含 一 个 视图 属性 ， 因 此 该 属性 会 被 添加 到 LayoutParams 的 属性 表 中 。 正 如 
CascadeLayout 类 ， 在 LayoutParams 类 的 构造 阔 数 中 读 取 这 个 新 属性 。 源 码 如 下 : 


public LayoutParams (Context context, AttributeSet attrs) ( 
super(context, attrs); 


TypedArray a = context.obtainStyledAttributes(attrs, 
R.styleable.CascadeLayout LayoutParams); 

try i 

verticalSpacing = a.getDimensionPixelSize( 
R.styleable.CascadeLayout LayoutParams layout vertical spacing, 
-—LE 3g 
) finally ( 
a.recycle(); 
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图 3-3 ”使 第 一 个 子 视图 具有 不 同 的 垂直 间距 


verticalSpacing 是 一 个 公共 字段 (field 成 员 变 量 ) ， 我 们 会 在 CascadeLayout 类 的 onMeasure () 方法 中 使 用 到 该 字段 。 


如 果子 视图 的 LayoutParams 包 含 verticalSpacing， 融 可 以 使 用 它 。 源 码 如 下 : 


verticalSpacing = mVerticalSpacing; 


LayoutParams lp = (LayoutParams) child.getLayoutParams(); 


if (lp.verticalSpacing >= 0) ( 
verticalSpacing = lp.verticalSpacing; 


width += child.getMeasuredWidtnh(); 
height += verticalSpacing; 


3.4 ”概要 


使 用 目 定义 View 和 ViewGroup 组 织 应 用 程序 布局 是 一 个 好 方法 。 定 制 组 件 的 同时 人 允许 开 上 友 者 提供 目 定义 行为 和 功能 。 以 
后 ， 开 友 者 在 需要 创建 复杂 布局 的 时 候 ， 首 先 应 该 考虑 使 用 目 定 义 ViewGroup 是 不 是 更 合适 。 虽 然 企 开始 时 ， 这 样 做 会 增加 一 


定 的 工作 量 ， 但 是 ， 这 是 值得 的 。 


35 Ah 


http://developer.android.com/guide/topics/ui/how-android-draws.html 
http:;//developer.android.com/reference/android/view/ViewGroup.html 


http:;//developer.android.com/reference/android/view/ViewGroup.LayoutParams.html 


Hack4 偏好 设置 使 用 技巧 
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Android SDK 中 提供 了 Preference (偏好 设置 ) 框架 ,我 很 喜欢 这 个 功能 。 相 对 于 iOS SDK， 使 用 这 个 功能 创建 偏好 设置 
界面 更 容易 一 些 。 开 发 者 只 需要 编辑 一 个 简单 的 XML 文件 ， 就 能 开 友 出 一 个 易 用 的 偏好 设置 界面 。 


尽管 Android 提 供 了 很 多 设置 控件 供 开 发 者 使 用 ， 但 是 很 多 时 候 ， 还 是 需要 开发 者 自己 定制 界面 。 在 这 个 Hack 提 供 的 示例 
代码 中 ， 读 者 会 学 到 如 何 定 制 设置 控件 。 最 终 的 Preference 界 面 如 图 4-1 所 示 : 


= | Tr. 


| Preferences 





Username 


Rate the app 


share it 


Send Feedback 


About 








首先 看 看 下 面 的 XML 文件 ， 源 码 如 下 : 


图 4-1 Preference Jtn 


<?xml version-"1.0" encoding-"utf-8"?» Figure 4.1 Prefi 
«PreferenceScreen 
xmlns:android-"http://schemas.android.com/apk/res/android" 





—> android:key- 


"pref first, preferencescreen key" 


为 Preference android:title-"Preferences"-» 
b e d. 
指定 android: «PreferenceCategory 使 用 PreferenceCategory 
key 属性 是 android:title="User"> 可 以 为 Preference 分 组 ， 
a. 4 4 14 H H e " 
上 很 好 HJ «EditTextPreference 并 指定 分 组 名 
习惯 ， 通 过 该 android:key-"pref username" 
属性 可 以 检索 android:summary-"Username" 选择 用 户 名 ， 需 要 使 
preference 对 象 android:title-"Username"/» JH EditfexiPrefstencs 
«/PreferenceCategory» 控件 。 这 里 指定 了 
小 A ip 1 
«PreferenceCategory summary 属性 的 默认 
为 那些 需 android:title-"Application"'» (B, 348 PE GEH PI 
mU `X i x M AN ` 
发 送 Intent <Preference 名 后 ， 该 默认 值 会 被 
的 选项 指定 android:key-"pref rate" EH 
| android:summary-"Rate the app in the store!" 
Preference android:title-"Rate the app"/» 
«Preference 
android:key-"pref share" 


android: 
android: 


summary-"Share the app with your friends" 
title-"Share it"/» 


«com.manning.androidhacks.hack004.preference.EmailDialog 


android:dialogIcon-"Gdrawable/ic launcher" 

android:dialogTitle-"Send Feedback" 

android:dialogMessage-"Do you want to send an email?" 

android:key-"pref sendemail key" 

android:negativeButtonText-"Cancel" 

android:positiveButtonText-"OK" 

android:summary-"Send your feedback by e-mail" 

android:title-"Send Feedback"/» 
«com.manning.androidhacks.hack004.preference.AboutDialog < 二 

android:dialogIcon-"Gdrawable/ic launcher" 


android: 
android: 
android: 
android: 


dialogTitle-"About" 


key-"pref about key" 可 以 创建 自 定义 Preference 
negativeButtonText="@null" 继承 已 有 的 控件 
title-"About"/» i 





</PreferenceCategory> 


</PreferenceScreen> 


上 面 创建 的 XML 文件 负责 UI 的 显示 。 接 下 来 添加 业务 逻辑 代码 ， 为 此 ， 需 要 创建 一 个 Activity， 这 个 Activity 不 能 继承 
android.app.Activity， 而 是 需要 继承 android.preference.PreferenceActivity。 源 码 如 下 所 示 : 


public class MainActivity extends PreferenceActivity implements 
OnSharedPreferenceChangeListener { 





s NAMEN UR 这 里 并 不 调用 setContentView() 
public void onCreate(Bundle savedInstanceState) ( 方法 ， 而 是 调用 addPreferences- 
super.onCreate(savedInstanceState); FromResource() 方法 fü AGE 
addPreferencesFromResource(R.xml.prefs); "P m 
方法 的 参数 是 之 前 创建 的 XML 
文件 
Preference ratePref = findPreference("pref rate"); 
Uri uri = Uri.parse("market://details?id-" + getPackageName()); 
Intent goToMarket - new Intent(Intent.ACTION VIEW, uri); 
ratePref.setIntent(goToMarket); 在 onCreate() 方法 中 ， 可 以 获取 
Preference， 并 为 其 设置 Intent， 
@Override fr 7k 例 中 ，ratePref 使 用 Intent. 
protected void onResume() { 


ACTION VIEW 


super.onResume(); - 


getPreferenceScreen().getSharedPreferences() 


.registerOnSharedPreferenceChangeListener (this); it 册 Preference 
) ARAE 3 ARI Ms Ur e 
GOverride 
protected void onPause() { 
getPreferenceScreen().getSharedPreferences() 
.unregisterOnSharedPreferenceChangeListener (this); < 注销 Preference 恋 
化 通知 监听 大 
@Override 


public void onSharedPreferenceChanged( 
SharedPreferences sharedPreferences, String key) ( 


if (key.equals("pref username")) ( X H P! Z Preference M 7E 
updateUserText(); 23 dd 
时 ， 需 要 更 新 该 Preference 
) 的 summary 
private void updateUserText() ( 
EditTextPreference pref; 
pref - (EditTextPreference) findPreference("pref username"); 





String user - pref.getText(); 


E summary, na 2 k X Preference, 


if (user -- null) ( 然后 调用 EditTextPreference 的 getText() 
user = "?"; dias 

方法 

pref.setSummary(String.format("Username: $s", user)); 


上 还 代码 展示 如 何 创建 自 定 义 的 Preference， 这 个 过 程 与 创建 自 定 义 视 图 相似 。 为 了 进一步 理解 Preference， 接 下 来 看 看 
EmailDialog， 源 码 如 下 : 


4.1 


e MEN extends DialogPreference ( 路 自 定义 类 需要 继承 自 其 
个 已 有 的 Preference 控 
ae ie 件 。 在 本 例 中 ， 我 们 继 

} | | 7K FH. DialogPreference 


public EmailDialog(Context context, AttributeSet attrs) ( 
this(context, attrs, 0); 


) 


public EmailDialog(Context context, AttributeSet attrs, 
int defStyle) { < 二 一 一 


fonken. abk TE 构造 方法 与 之 前 
super(context, attrs, defStyle); Mp 
mContext - context; 创建 的 继承 日 
} View 类 的 日 定义 
视图 相同 


@Override 


public void onClick(DialogInterface dialog, int which) { 


«1—4 - 4 : ! 
super.onClick(dialog, which); 383 onClickQ 77 
— . — 法 。 如 果 用 户 点 
1 DialogIntertace.BUTTON POSITIVE == whic i TN 

LaunchEmailUtil.launchEmailToIntent (mContext); di OK 按钮 ， A 
} 们 使 用 辅助 类 发 
} 送 启 动 email 的 
} Intent 


慨 要 


尽管 偏好 设置 框架 允许 开 友 者 添加 自 定义 功能 ,但 是 ， 有 一 点 必须 注意 : 偏好 设置 框架 的 目的 是 创建 简单 的 偏好 设置 界面 。 


如 果 开 友 者 想 添 加 更 多 复杂 的 UI 控件 或 者 逻辑 ， 我 建议 单独 创建 一 个 Activity 并 使 用 Dialog 的 主题 ， 然 后 从 偏好 设置 控件 上 局 动 


[z^ 


4.2 ^M 


http:;//developer.android.com/reference/android/preference/PreferenceActivity.html 


第 2 草 ” 湛 加 悦目 的 动画 效果 


本 章 学 习 动 画 相 关内 容 。 从 本 章 的 示例 代码 中 ， 读 者 可 以 学 到 如 何 使 用 各 种 API 为 应 用 程序 控件 添加 动画 效果 。 


Hack 5 ”使 用 TextSwitcher 和 和 lImageSwitcher 实 现 平滑 过 法 


Android v1.6+ 

假设 你 需要 在 TextView 或 者 ImageView 中 循环 浏览 信息 。 举 例如 下 : 
:通过 向 左 和 向 右 的 导航 按钮 浏览 日 期 列表 

- 在 日 期 选择 控件 中 改变 日 期 

-倒计时 时 钟 

-新闻 纲要 


更 改 视图 中 的 内 容 是 多 数 应 用 程序 的 基本 功能 ， 但 是 这 未 必 是 单调 无 趣 的 。 如 果 使 用 默认 的 TextView 控 件 ， 你 会 友 现 当 切 
换 其 内 容 时 ， 并 没有 有 民 好 的 视觉 体验。 因此 如 果 有 一 种 方法 可 以 为 内 容 切 换 添加 动画 效果 束 太 好 了 。 为 了 使 过 渡 过 程 的 视 完 效果 
更 自然 ，Android 提 供 了 TextSwitcher 和 lImageSwitcher 这 两 个 类 分 别 替 代 TextView 与 ImageView.。 


TextView 和 TextSwitcher 的 机 制 是 类 似 的 。 回 到 上 文 所 述 的 例子 ， 假 设 用 户 正 在 浏览 一 个 日 期 列表 ， 每 当 点 击 按钮 时 ， 就 
需要 更 改 TextView 内 显示 的 日 期 。 使 用 mTextView.setText ("something") 方法 更 新 TextView 中 的 内 容 。 具 体 代码 如 下 所 


Z7: 
private TextView mTextView; 


QOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
mTextView = (TextView) findViewById(R.id.your textview); 


mTextView.setText("something"); 


读者 可 能 会 注意 到 ，TextView 的 内 容 是 立刻 改变 的 。 如 果 需 要 添加 动画 效果 以 避免 这 种 生硬 的 内 容 切 换 方式 ， 束 需要 使 用 
TextSwitcher。TextSwitcher 用 于 为 文本 标签 添加 动画 效果 。 当 调用 TextSwitcher 的 相关 方法 时 ，TextSwitcher 便 会 以 动画 的 
方式 换 出 当前 文本 ， 并 换 入 新 的 文本 。 要 获得 这 种 让 用 户 愉悦 的 过 渡 效 果 ， 只 需要 以 下 几 个 简单 步骤 : 


1) 通过 findViewByld () 万 法 获取 TextSwitcher 对 象 的 引用 switcher， 当 然 也 可 以 直接 在 代码 中 构造 该 对 象 。 
2) 通过 switcher.setFactory () 方法 指定 TextSwitcher 的 View-Factory。 

3) 通过 switcher.setInAnimation () 方法 设置 换 入 动画 效果 。 

4) 通过 switcher.setOutAnimation () 方法 设置 换 出 动画 效果 。 


TextSwitcher 的 工作 原理 是 : 首先 通过 ViewFactory 创 建 两 个 用 于 在 TextSwitcher 中 切换 的 视图 ， 每 当 调用 setText () 方 


法 时 ，TextSwitcher 首 先 移 除 当前 视图 并 显示 setOutAnimation () 方法 设置 的 动画 ， 然 后 并 将 另 一 个 视图 切换 进来 ， 并 显示 
setinAnimation () 方法 设置 的 动画 。 使 用 方法 如 下 所 示 : 


private TextSwitcher mTextSwitcher; 


aOverride 
public void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
Animation in - AnimationUtils.loadAnimation(this, 
android.R.anim.fade in); 
Animation out - AnimationUtils.loadAnimation(this, 
android.R.anim.fade out); 


mTextSwitcher = (TextSwitcher) findViewById(R.id.your textview); 
mTextSwitcher.setFactory(new ViewFactory() ( 


QOverride 

public View makeView() ( 
TextView t - new TextView(YourActivity.this); 
t.setGravity(Gravity.CENTER); 
return t; 


} 
A 


mTextSwitcher.setInAnimation(in); 
mTextSwitcher.setOutAnimation(out); 


BJXZAÍBER, SZJ UTREE XAAS, MORI ESHJAUBDGUR. I81X X NIA COABJAÁGS AORLDNTHI MANI ES ERR T 
旧 的 文本 内 容 。 在 本 例 中 ， 使 用 的 是 android.R.anim.fade in， 这 是 一 个 淡 入 效果 ， 也 可 以 使 用 其 他 效果 ， 步 又 是 一 样 的 ， 因 此 
读者 可 以 党 试 使 用 自 定义 动画 效果 或 者 android.R.anim 中 定义 的 任意 动画 效果 。lmageSwitcher 与 TextSwitcher 的 原理 是 一 样 
的 ， 只 不 过 前 者 切换 的 是 图 片 ， 后 者 切换 的 是 文本 。 


5.1 概要 


Textswitcher 和 Imageswitcher 提 供 了 添加 过 渡 动 画 的 简单 方法 。 提 供 这 两 个 控件 的 目的 是 为 了 让 过 渡 更 目 然 ， 因 此 不 要 
小 用 它们 ， 谁 也 不 想 把 目 己 的 应 用 程序 点 缀 得 像 一 颗 圣诞 树 那 样 不 目 然 。 


5.2 ”外 部 链 接 


http://developer.android.com/reference/android/widget/Text-Switcher.html 


http:;//developer.android.com/guide/topics/graphics/view-animation.htm 


Hack6 7S3ViewGroupBS-f HH staS T HIER 
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默认 情况 下 ， 添 加 到 ViewGroup 中 的 子 视图 是 直接 显示 出 来 的 。 有 一 个 比较 简单 的 方法 可 以 为 这 个 过 程 增加 动画 效果 。 在 
这 个 Hack 里 ， 我 们 学 习 如 何 为 ViewGroup 的 子 视 图 添加 动画 效果 。 下 面 展 示 如 何 通过 灾 谓 几 行 代码 便 能 为 应 用 程序 增添 悦目 的 
动画 效果 。 


Android 提 供 了 LayoutAnimationController 类 ， 用 于 为 布局 或 者 ViewGroup 的 子 视图 添加 动画 效果 。 有 一 点 需要 强调 ， 开 
发 者 不 可 以 为 每 个 子 视图 分 别 指定 不 同 的 动画 效果 ， 但 是 LayoutAnimation-Controller 可 以 决定 各 个 子 视图 显示 动画 效果 的 时 
[B]. 


通过 例子 来 理解 如 何 使 用 LayoutAnimationController 是 一 个 好 方法 。 在 下 面 的 例子 中 ， 我 们 将 结合 透明 度 渐变 动画 
(alpha animation) 和 位 移动 画 (translate animation) 演示 如 何 给 ListView 的 子 视 图 添加 动画 效果 。 使 用 
LayoutAnimationController 的 方法 有 两 种 : 直接 在 代码 中 使 用 或 者 在 XML 文件 中 配置 。 我 会 演示 如 何在 代码 中 使 用 
LayoutAnimationController， 感 兴趣 的 读者 可 以 目 己 试 试 企 XML 文 件 中 配置 的 方法 。 添 加 动画 效果 的 源码 如 下 所 示 : 


mListView = (ListView) findViewById(R.id.my listview id); jk HX. List- 
View 的 
>  AnimationSet set = new AnimationSet(true); 引用 
I 
Jl. 
A) a E Animation animation - new AlphaAnimation(0.0f, 1.0f); q | 创建 透明 
D zii animation.setDuration(50); 度 渐 变动 


set.addAnimation (animation); 


HE A 2 ' A 
EGIS iii 
animation = new TranslateAnimation(Animation.RELATIVE TO SELF, 0.0f, 
Animation.RELATIVE TO SELF, 0.0f, Animation.RELATIVE TO SELF, 
-1.0f, Animation.RELATIVE TO SELF, 0.0f); < 一 一 创建 位 移 
animation.setDuration(100); -h ii ME 
将 Layout- set.addAnimation(animation); 
Animation- LayoutAnimationController controller - new LayoutAnimationController( 
x set, 0.5); ^ . 3 : 
Controller ) 创建 LayoutAnimationCon- 
对 象 设 置 到 ~ mListView.setLayoutAnimation(controller); troller 对 象 并 设置 子 视图 
ListView 中 动 夯 效果 持 绪 时 间 


首先 如 @@ 中 所 示 ， 需 要 获得 ListView 的 引用 。 然 后 如 @ 中 所 示 ， 由 于 需要 添加 多 个 动画 效果 ， 因 此 创建 一 个 动画 集合 
AnimationSet。 传 入 AnimationSet 构 造 函 数 的 布尔 型 参数 决定 每 个 动画 是 不 是 使 用 同一 个 interpolatorl']， 在 本 例 中 ， 使 用 默 
认 interpolator。 之 后 如 @ 和 @ 中 所 示 ， 依 次 创建 透明 度 渐变 动画 和 过 渡 动 画 ， 并 将 其 添加 a 到 动画 集合 中 。 骨 之 后 ， 如 @@ 中 所 
示 ， 以 动画 集合 和 动画 持续 时 间 为 参数 创建 LayoutAnimationController 对 象 。 最 后 ， 如 @@ 中 所 示 ， 把 这 个 
LayoutAnimationController 对 象 应 用 到 ListView 中 。 


框架 层 提供 的 多 数 动画 控件 与 TranslateAnimation 相 似 ， 下 面 分 析 TranslateAnimation 的 源 代 码 ， 其 构造 函数 定义 如 下 : 


public TranslateAnimation(int fromXType, float fromXValue, int toXType, 
float toXValue, int fromYType, float fromYValue, int toYType, 
float toYValue) { 


该 接口 很 简单 ， 需 要 传 入 x 轴 和 y 轴 的 起 始 与 结束 坐标 。Android 提 供 了 三 个 选项 ， 用 于 指定 计算 坐标 的 参照 : 
- Animation. ABSOLUTE 
- Animation. RELATIVE, TO. SELF 
- Animation. RELATIVE, TO. PARENT 
回 到 上 面 的 例子 ， 我 们 可 以 用 下 面 的 词汇 表示 每 个 子 视图 的 位 置 : 
Initial X: 父 视 图 指定 的 起 始 X 坐 标 
Initial Y: 父 视 图 指定 的 起 始 Y 坐 标 
"Final X: 父 视图 指定 的 结 来 X 坐 标 


Final Y: 父 视 图 指定 的 结束 Y 坐 标 


上 述 示例 程序 的 最 终 效果 是 : 每 个 子 视图 四 沿 Y 轴 方向 依次 滑落 到 各 自 的 位 置 上 ， 同 时 由 于 子 视 图 之 间 有 一 定 延 迟 ， 所 以 整 
体 看 起 来 像 瀑 布 一 样 。 





[1] Interpolator 的 概念 请 参照 http://developer.android.com/reference/android/view/animation/Interpolatotr.html。 译 者 注 


[2] 本 例 中 的 子 视图 即 ListView 中 的 每 个 Item。 





译 者 注 


6.1 概要 
为 ViewGroup 添 加 动画 效果 是 比较 简单 的 。 动 画 会 令 应 用 程序 看 起 来 更 专业 更 精练 。 这 个 Hack 只 涉及 一 小 部 分 内 容 ， 开 发 


者 可 以 完善 本 章 的 示例 程序 。 比 如 ， 开 发 者 可 以 将 默认 interpolator 蔡 换 为 Bouncelnterpolator， 这 样 ， 当 子 视图 滑落 到 预定 位 
置 时 ， 会 出 现 弹跳 效果 。 此 外 ， 还 可 以 控制 子 视 图 动画 的 显示 顺序 。 


发 挥 想象 力 去 创建 一 些 烃 酷 的 效果 ， 但 是 请 记 住 ， 过 犹 不 及 一 一 开发 者 应 该 避免 使 用 太 多 的 动画 效果 。 


6.2 ”外 部 链接 


http:;//developer.android.com/reference/android/view/animation/LayoutAnimationController.html 


Hack 7 在 Canvas 上 显示 动画 
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如 果 读 者 想 为 自 定义 的 Ul 控 件 添 加 动画 效果 ， 会 发 现 动 画 相关 的 API 是 很 有 限 的 。 那 有 没有 API 可 以 直接 向 屏幕 绘图 呢 ? 2m 
案 是 肯定 的 。Android 提 供 了 Canvas 类 满足 这 一 需求 。 

在 这 个 Hack 里 ， 我 以 方块 在 屏幕 上 弹跳 为 例 分 析 如 何 使 用 Canvas 类 在 屏幕 上 绘制 图 形 ， 并 为 其 添加 动画 效果 。 应 用 程序 最 
终 效果 如 图 7-1 所 示 : 


编写 应 用 程序 前 ， 需 要 读者 首先 确认 是 否 已 经 理解 了 Canvas 类 的 基本 概念 ， 下 面 的 解释 摘自 开发 文档 ( 见 7.2 节 ) ， 内 容 如 
F: 


“可 以 把 Canvas 视 为 Sutface 的 替身 或 者 接口 ， 图 形 便 是 绘制 在 Sutface 上 的 。Canvas 封 装 了 所 有 绘图 调用 。 通 过 Canvas， 绘 制 到 


Surface 上 的 内 容 首先 存储 到 与 之 关联 的 Bitmap 中 ， 该 Bitmap 最 终 会 呈现 到 窗口 上 。” 


基于 上 述 定义 ，Canvas 类 封 半 了 所 有 绘图 调用 ， 我 们 可 以 创建 一 个 View (视图 ) ， 重 写 其 onDraw () DA, ADAP 
便 可 以 绘制 基本 的 图 形 单元 。 








图 7-1 在 屏幕 内 弹跳 的 方块 


为 了 加 深 理解 ， 创 建 DrawView 类 ， 该 类 负责 在 屏幕 上 绘制 一 个 方块 ， 并 不 断 更 新 方块 的 位 置 ， 除 此 之 外 ， 屏 幕 上 没有 其 他 
控件 了 。 以 DrawView 作 为 Activity 的 内 容 视 图 (Content View) ，Activity 的 代码 如 下 : 
public class MainActivity extends Activity ( 

private DrawView mDrawView; 

QGOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); & DU Hr B£ Py 

的 宽 和 高 


Display display = getWindowManager().getDefaultDisplayv(); 
mDrawView - new DrawView(this); 
mDrawView.height - display.getHeight(); 


mDrawView.width - display.getWidth(); Q Draw View 占据 所 
setContentView (mDrawView); a 有 可 用 空间 


在 @ 中 ， 通 过 WindowManager 获 取 屏 幕 的 宽 和 高 ， 这 些 值 用 于 限制 DrawView 的 绘图 范围 。 然 后 ， 在 @ 中 ， 将 DrawView 


设置 为 Activity 的 内 容 视图 ， 表 示 DrawView 会 占据 界面 的 所 有 可 用 空间 。 


接 下 来 看 看 DrawView 类 的 实现 代码 ， 源 码 如 下 所 示 : 


public class DrawView extends View ( 
private Rectangle mRectangle; 
public int width; 
public int height; 


public DrawView(Context context) { 


super (context); 创建 方 


mRectangle = new Rectangle(context, this); q 块 对 象 
mRectangle.setARGB(255, 255, 0, 0); 

mRectangle.setSpeedX(3); 

mRectangle.setSpeedY(3); 


} 
FR , 
QGOverride 变换 方块 
protected void onDraw(Canvas canvas) ( 位 置 
mRectangle.move(); < 
mRectangle.onDraw(canvas); < 一 一 一 将 方块 绘制 
invalidate(); < ) 到 Canvas 上 
) Q7 View 


首先 ， 在 @ 中 ， 创 建 一 个 Rectangle 实 例 ， 代 表 一 个 方块 。Rectangle 类 内 部 实现 了 将 自身 绘制 到 Canvas 上 的 逻辑 ， 并 且 已 
经 包含 了 正确 变换 其 位 置 的 代码 逻辑 。 当 调用 onDraw () 方法 时 ， 通 过 @， 方 块 的 位 置 就 会 改变 ， 然 后 通过 G@) 绘 制 到 Canvas 
上 。 在 @ 中 ，invalidate () 方法 本 身 融 是 一 个 小 技巧 ， 这 个 方法 强制 重 绘 视图 。 把 这 个 方法 放 在 onDraw () 的 目的 是 为 了 在 
View 绘 制 完 自身 后 ， 可 以 立即 重新 调用 onDraw () 方法 。 换 句 话 训 ， 通 过 循环 调用 Rectangle 的 move () 和 onDraw () 75 
法 实现 一 个 动画 效果 。 


7.1 概要 


在 onDraw () 方法 中 通过 调用 invalidate () 方法 变换 视图 的 位 置 是 实现 目 定义 动画 的 简单 方法 。 如 果 读 者 打算 开 友 一 各 
小 洲 戏 ， 使 用 这 个 小 扩 巧 处 理 游戏 的 主 循环 是 一 个 简单 的 方法 。 


7.2 ”外 部 链接 


http:;//developer.android.com/reference/android/graphics/Canvas.html 


http://developer.android.com/guide/topics/graphics/2d-graphics.html 


Android v1.6- 


我 们 公司 早期 开 友 过 一 蒜 产 品 叫 FeedTV， 这 球 产 品 的 创意 是 变革 RSS 源 (RSSfeed) 的 阅读 方式 。 为 了 避免 给 用 户 显 示 一 
个 见长 的 列表 ，FeedTV 提 供 类 似 于 相框 程序 的 界面 来 展示 RSS 源 的 标题 和 主 图 。FeedTV 运 行 于 iPad 的 效果 如 图 8-1 所 示 。 


U.S. goes after financial firms 





图 8-1 FeedTV 运 行 于 iPad 的 效果 


为 了 让 界面 看 起 来 更 酷 ， 我 们 不 显示 静 仿 图 片 ， 而 是 通过 分 析 图 片 的 大 小 和 宽 高 比 ， 加 入 所 谓 的 Ken Burns 特 效 。Ken 
Burns 特 效 只 不 过 是 视频 产品 中 使 用 的 一 种 平移 和 缩放 静态 图 片 的 特效 。 理 解 Ken Burns 特 效 最 直观 的 万 式 是 观看 一 段 视频 ， 
8-2 也 可 以 让 读者 对 其 有 个 初步 了 解 。 





图 8-2 ”维基 百科 上 Ken Burns 特 效 的 例子 


在 这 个 Hack 里 ， 我 会 向 读者 展示 如 果 人 在 图 像 幻 灯 片 (Image Slideshow) 里 模拟 Ken Burns 特 效 。 要 实现 这 个 功能 ， 需 要 
使 用 Jake Wharton 开 发 的 Nine Old Androids 库 。 这 个 库 可 以 让 开发 者 在 旧版 本 上 使 用 Android 3.0 的 动画 APl。 


要 创建 Ken Burns 特 效 ， 需 要 预 设 一 些 动画 。 这 些 动 画 将 随机 应 用 到 ImageView， 当 一 个 动画 显示 完毕 ， 就 开始 显示 另 一 
个 动画 和 图 片 。 主 布局 使 用 FrameLayout， 把 ImageView 置 于 该 布局 中 。 创 建 布 局 的 代码 如 下 所 示 : 


GOverride 
public void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 


mContainer - new FrameLayout(this); 

mContainer.setLayoutParams(new LayoutParams ( a f & f 
LayoutParams.FILL PARENT, LayoutParams.FILL PARENT)); DENE 

mView = createNewView(); 

mContainer.addView (mView); «T— 他 建 ImageView , 并 将 其 


As JI f eg Ar P 


setContentView(mContainer); 


) 


private ImageView createNewView() ( 
ImageView ret - new ImageView(this); 
ret.setLayoutParams(new LayoutParams (LayoutParams.FILL PARENT, 
LayoutParams.FILL PARENT)); 


rt = peces 
ret.setScaleType(ScaleType.FIT XY); 议 置 要 显示 的 
ret.setImageResource (PHOTOS [[mIndex]); < KE, 并 设置 
mIndex = (mIndex + 1 < PHOTOS.length) ? mIndex + 1 : O0; 下 一 个 要 显示 
return ret; H9 ALAS RS 


到 目前 为 止 ， 一 切 顺 利 。 接 下 来 ， 首 先 通 过 createNewView () 方法 创建 ImageView 对 象 ， 以 此 来 引用 下 一 个 要 显示 的 图 
片 。 然 后 创建 nextAnimation () 万 法 ， 这 个 方法 负责 设置 动画 并 局 动 动画 。 代 码 如 下 所 示 : 


private void nextAnimation() ( 
AnimatorSet anim = new AnimatorSet(); 


final int index - mRandom.nextInt(ANIM COUNT); < 随机 选择 动 转 
switch (index) { 
case 0: 
anim.playTogether( Zn n. 
ObjectAnimator.ofFloat(mView, "scaleX", 1.5f, 1f), 动画 
ObjectAnimator.ofFloat(mView, "scaleY", 1.5f, 1f£)); 
break; 
case 3: 
default: 
AnimatorProxy.wrap(mView).setScaleX(1.5f); < 
AnimatorProxy.wrap(mView).setScaleY(1.5f); Er 
anim.playTogether (ObjectAnimator.ofFloat (mView, 
"translationX", Of, 40f)); 
break; /— EET mm 
设置 动画 持续 时 间 ， 设 


"Er zJ] pj UA TT mu y 24 Bi 
Activity, JA zZ z2) E] 


anim.setDuration(3000); 
anim.addListener (this); 
anim.start(); 


在 @ 中 ，AnimatorProxy 是 定义 于 Nine Old Androids 库 中 的 类 ， 用 于 修改 View 的 属性 。 这 个 新 的 动画 框架 的 基础 是 : 视 
图 的 属性 随 着 时 间 的 推移 可 以 改变 。 之 所 以 使 用 AnimatorProxy， 是 因为 在 Android 3.0 以 下 版 本 ， 有 些 属性 没有 
getters/setters73;Z. 


余下 的 代码 便 是 在 动画 结束 的 时 候 调 用 nextAnimation () 万 法 。 记 住 ， 在 @ 中 将 当前 Activity 设 置 为 动画 监听 器 。 接 下 
来 ， 我 们 看 看 需要 重 写 哪些 方法 。 源 码 如 下 所 示 : 


@Override 

public void onAnimationEnd (Animator animator) { M. di J 4x a8 P ES ER 
mContainer.removeView(mView); <4— Z BjH View, Jf ids 
mView - createNewView(); 


加 新 的 View 


mContainer.addView(mView); 


nextAnimation(); 二 开始 显示 下 一 个 动画 
} 


仅 此 而 已 ， 我 们 便 为 每 幅 图 片 都 添加 了 Ken Burns 特 效 。 读 者 可 以 尝试 修改 两 个 地 万 来 改进 上 面 的 例子 : 当 切 换 视 图 时 ， 添 


加 透明 度 渐 变动 画 (alpha animation) 并 且 添 加 一 个 Animationset 同 时 显示 平移 和 缩放 动画 。 读 者 可 以 从 Nine Old Androids 
库 的 示例 代码 中 获得 更 多 局 友 。 


8.1 概要 


新 的 动画 API 通 弟 可 以 比 旧 的 API 实 现 更 多 潜在 功能 。 以 下 是 新 API 一 些 改 进 的 简短 列表 : 


- 旧版 本 的 API 只 支持 视图 对 象 的 动画 效果 。 
- 旧版 本 的 API 仅 限于 和 移动、 旋转、 缩放、 渐变 等 效果 。 
- 旧版 本 的 API 只 改变 视图 移动 时 的 视觉 效果 ， 并 未 改变 其 真实 位 置 属性 。 


事实 上 ， 像 Nine Old Androids 这 样 的 库存 在 整 意 味 着 我 们 有 理由 在 新 的 API 上 尝试 这 些 特效 。 


8.2 ”外 部 链接 


www.nasatrainedmonkeys.com/portfolio/feedtv/ 
https://github.com/JakeWharton/NineOldAndroids 
http:;//en.wikipedia.org/wiki/Ken Burns effect 
http://android-developers.blogspot.com.ar/2011/02/animation-in-honeycomb.html 


http://android-developers.blogspot.com.ar/2011/05/introducing-viewpropertyanimator.html 
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本 草 介 绍 使 用 视图 的 各 种 技巧 。 这 些 瓜 15 展 示 了 如 果 通 过 上 自 定义 或 者 微调 Ul 控件 来 实现 特定 的 功能 。 


Hack 9 ”避免 在 EditText 中 验证 日 期 


Android v1.0 十 


开发 者 都 知道 验证 表单 [里 的 数据 是 令 人 厌烦 而 且 容 易 出 错 的 。 我 曾经 开发 过 一 个 应 用 程序 ， 这 个 应 用 程序 使 用 了 大 量 表 单 
并 且 有 多 个 日 期 输入 框 。 我 不 想 验 证 每 个 日 期 字段 ， 因 此 想 出 一 个 简洁 的 方法 避免 这 个 验证 过 程 。 该 方法 的 思路 是 : 开发 一 个 外 
观看 起 来 与 EditText 相 同 的 Button， 点 击 该 Button 后 ,会 显示 一 个 DatePicker 控 件 。 


要 实现 上 面 的 思路 ， 需 要 把 Button 控 件 的 默认 背景 修改 为 EditText 的 背景 。 方 法 很 简单 ， 只 需要 修改 XML 文件 即 可 ， 源 码 
如 下 所 示 : 


«Button android:1i1d="@+id/details date" 
android:layout width-2"wrap content" 


android:layout height-"wrap content" 
android:gravity-"center vertical" 
android:background-"QGandroid:drawable/edit text" /> 


注意 到 没有 ”我 们 并 没有 使 用 目 定 义 图 片 指定 背景 ， 而 是 使 用 了 @android: drawable。 在 应 用 程序 中 使 用 Android 内 置 资 
源 有 利 有 产 。 有 利 的 一 面 是 可 以 使 应 用 程序 更 好 地 适应 不 同 设备 ， 不 利 的 一 面 是 应 用 程序 在 不 同 设备 上 的 用 尸体 验 有 可 能 不 同 。 
一 些 开 上 友 者 喜欢 使 用 目 定 义 资 源 、 图 片 和 主题 保持 应 用 程序 的 外 观 一 致 。 


如 果 读 者 在 不 同 设备 上 测试 应 用 程序 ， 会 友 现 UI 控件 的 样式 有 可 能 是 不 一 样 的 ， 使 用 Android 内 置 资 源 ， 会 让 应 用 程序 选择 
Android 的 样式 。 


创建 Button 后 ， 还 需要 为 其 设置 点 击 事件 监听 器 。 源 码 如 下 所 示 : 
mDate = (Button) findViewById(R.id.details date); 
mDate.setOnClickListener(new OnClickListener() { 


aOverride 
public void onClick(View v) { 
showDialog (DATE DIALOG ID); 


r3 


在 余下 的 代码 逻辑 中 ， 会 弹出 一 个 DatePicker 控 件 ， 当 用 户 选择 一 个 日 期 后 ， 该 日 期 的 文本 会 被 设置 到 Button 上 显示 出 
来 2 


1] 英文 意思 是 form， 通 常 表示 界面 上 的 各 种 输入 框 





译 者 注 
[2] 截止 本 书 翻译 时 ，Hack009 示 例 代 码 中 并 没有 将 日 期 文本 设置 到 Button 上 的 逻辑 ， 此 需要 在 onDateSet 回 调 方 法 中 添加 这 部 分 
记 辑 才能 正常 显示 选择 的 日 期 。 





译 者 注 


9.1 概要 


细心 的 读者 内 心 可 能 会 有 这 样 的 疑问 : 为 什么 不 直接 为 EditText 设 置 一 个 点 击 监听 器 ， 而 非 要 使 用 Button 呢 ? 答案 是 : 使 
用 Button 更 安全 ， 因 为 用 户 无 法 修改 Button 的 文本 内 容 。 如 果 使 用 EditText， 并 且 只 设置 了 点 击 监听 器 ， 用 户 可 以 通过 光标 获 
取 该 控件 的 焦点 ， 这 样 便 可 以 绕 过 DatePicker 控 件 直接 修改 EditText 的 文本 内 容 。 


读者 也 可 以 用 TextWatcher 验 证 EditText 中 的 用 户 输入 信息 ， 但 是 ， 这 种 方法 是 很 烦琐 目 耗 时 的 。 使 用 本 Hack 提 供 的 方法 
可 以 简化 代码 并 避免 输入 错误 。 最后， 请 记 住 ， 在 应 用 程序 中 使 用 Android 内 置 资 源 是 一 个 借用 设备 样式 (Style) 的 好 方法 。 


9.2 外 部 链接 


http:;//developer.android.com/reference/android/widget/DatePicker.html 


http:;//developer.android.com/reference/android/widget/EditText.html 


Hack 10 格式 化 TextView 的 文本 


Android v1.6+ 


假设 要 在 Twitter 应 用 程序 上 显示 如 图 10-1 所 示 的 推 文 (tweet) 。 请 注意 这 条 推 文 里 文本 样式 的 不 同 。 你 或 许 会 认为 这 是 
Twitter 创建 的 目 定义 视图 ， 但 是 这 个 UI 控 件 是 用 TextView 实 现 的 。 





Multiple-APK Support in Android 





Market: goo.gl/0TX2B (via 
«'AndroidDev) 


图 10-1  Twitterzm f^ 


很 多 情况 下 ， 开 友 痢 需要 添加 一 些 特殊 样式 的 文本 来 突出 重点 内 容 或 者 为 链接 提供 视 名 反馈 ， 以 此 提高 应 用 程序 的 用 户 友 好 
度 。 还 有 其 他 例子 可 以 说 明文 本 样式 的 用 途 ， 举 例如 下 : 


` 为 电话 号 码 显示 链接 。 
` 为 文本 的 不 同 部 分 添加 不 同 的 背景 色 。 
在 这 个 Hack 里 ， 我 会 分 析 如 果 使 用 TextView 添 加 不 同样 式 的 文本 和 链接 。 


首先 ， 我 们 添加 超 链接 。 可 以 通过 Html.fromHtml () 方法 设置 TextView 的 文本 内 容 。 文 本 内 容 需 要 简单 处 理 : 在 
TextView 的 文本 内 容 中 坐 入 HTML 人 代码。 代码 如 下 所 示 : 


mTextViewl = (TextView) findViewById(R.id.my text view html); 
String text - 

"Visit «a href-zWM"http://manning.com/M"»Manning home page-c/a»"; 
mTextViewl.setText(Html.fromHtml(text)); 
mTextViewl.setMovementMethod(LinkMovementMethod.getInstance()); 


在 TextView 中 使 用 HTML 代 码 设置 样式 比较 容易 理解 ， 那 么 Html.fromHtml () 方法 做 了 些 什么 ? 它 的 返回 值 又 是 什么 ? 
该 方法 将 HTML 转 化 为 一 个 Spanned 对 象 ， 并 以 此 为 参数 调用 TextView 的 setText () 方法 。 


现在 ,我 们 尝试 另外 一 种 方法 。 我 们 不 使 用 HTML 格 式 化 文本 内 容 ， 而 是 使 用 SpannableStringl 类 创建 一 个 Spanned 对 
象 。 源 人 码 如 下 所 示 : 

mTextView2 = (TextView) findViewById(R.id.my text view spannable); 

Spannable sText = new SpannableString (mTextView2.getText()); 

sText.setSpan(new BackgroundColorSpan(Color.RED), 1, 4, 0); 


sText.setSpan(new ForegroundColorSpan(Color.BLUE), 5, 9, 0); 
mTextView2.setText(sText); 


上 述 两 段 代码 的 运行 结果 如 图 10-2 所 示 。 用 法 比较 简单 : 我 们 通过 文本 中 字符 的 系 引 指定 不 同 的 跨度 (span) ， 不 同 的 跨 
度 将 文本 内 容 分 成 不 同 的 部 分 ， 然 后 通过 spannablestring 瓯 可 以 为 不 同 部 分 指定 不 同 的 样式 。 
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al [e id, HomeActivity! 





图 10-2 使 用 spannable 样 式 的 TextView 





[1] SpannableString 是 Spanned 的 子 类 ， 参 见 http://developer.android.com/reference/android/text/Spanned.html 译 者 注 


10.1 概要 


TextView 是 Android 提 供 的 一 个 简单 却 功能 强大 的 UI 控件 。 读 者 可 以 在 应 用 程序 中 通过 多 种 方法 使 用 不 同样 式 的 文本 。 尽 
管 TextView 并 不 支持 所 有 HTML 标 签 ， 但 是 用 于 格式 化 文本 内 容 已 经 足够 了 ， 放 心 使 用 它 吧 。 


10.2 ”外 部 链接 


http://developer.android.com/reference/android/widget/TextView.html 


Hack 11 为 文本 添加 友 腕 的 效果 


Android v1.6- 


假如 读者 需要 开发 一 个 显示 时 间 的 应 用 程序 ， 还 记得 那些 显示 高 亮 绿灯 的 数字 时 钟 吗 ? 在 这 个 Hack 里 ,我 向 读者 展示 如 果 
通过 微调 Android 的 TextView 控 件 来 生成 这 样 的 效果 。 最 终 效果 如 图 11-1 所 示 。 





图 11-1 ”数字 时 钟 demo 


首先 需要 创建 继承 上 自 TextView 的 LedTextView 类 ， 通 过 这 个 类 设置 一 种 特殊 的 字体 ， 让 视图 的 文本 内 容 看 起 来 与 LED (E 
光 二 极 管 ) 中 显示 的 一 样 。 源 码 如 下 所 示 : 


public class LedTextView extends TextView { 


public LedTextView(Context context, AttributeSet attrs) ( 
super (context, attrs); 


AssetManager assets = context.getAssets(); qe 
final Typeface font - Typeface.createFromAsset(assets, 

FONT DIGITAL 7); 
setTypeface(font); 


当 创 建 对 象 时 ， 我 们 从 assets 文 件 夹 中 获取 字体 信息 ， 然 后 在 中 设置 该 字体 。 这 样 便 拥有 一 个 可 以 使 用 自 定义 字体 显示 文 
本 内 容 的 UI 控件 。 接 下 来 需要 考虑 的 事情 便 是 如 何在 文本 上 绘制 数字 。 如 果 读 者 仔细 观察 图 11-1， 会 发 现 可 以 通过 两 个 
TextView 实 现 。 第 一 个 TextView 是 背景 中 显示 88: 88: 88 的 阴影 ， 第 二 个 TextView 用 于 显示 当前 时 间 。 


为 了 实现 发 光 的 效果 ，TextView 提 供 了 一 个 方法 ， 其 方法 签名 如 下 所 示 : 
public void setShadowLayer (float radius, float dx, float dy, int color) 


也 可 以 通过 XML 中 的 android: shadowColor, android: shadowDx, android: shadowDy 和 android: shadowRadius 
属性 使 用 这 种 效果 。XML 文 件 内 容 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"-» 


«com.manning.androidhacks.hack011.view.LedTextView 
android:layout width-"wrap content" 
android:layout height-2"wrap content" 
android:layout centerInParent-"true" 
android:text-"88:88:88" 


android:textSize-"80sp" 
android:textColor-z"£$3300FF00"/» 


“设置 较 浅 的 
<com.manning .androidhacks .hack011 .view.LedTextView Q9. 以 使 
android:id-"G-«id/main clock time" 文本 看 起 来 


android:layout width-"wrap content" 
android:layout height-2"wrap content" 透明 些 
android:layout centerInParent-"true" 
android:text-"08:43:02" 
android:textSize-"80sp" "— ios 
android:textColor-z"4£00FFO00" 0 7 EX RIBI x 
android:shadowColor-"£$00FF00" <4 颜色 相同 
android:shadowDx-"O0" 

android:shadowDy-"0" 


android:shadowRadius-"10"/» H 改变 阴影 半径 ， 使 
«/RelativeLayout-» 全 其 看 起 来 更 亮 些 


第 一 个 LedTextView 用 于 绘制 界面 下 层 的 88: 88: 88， 其 目的 是 模拟 数字 时 钟 中 的 重 影 效 果 。 我 们 在 @@ 中 通过 把 文本 颜色 
设置 的 稍微 透明 一 点 来 达到 这 个 目的 。 第 二 个 LedTextView 用 于 显示 当前 时 间 ， 注 意 在 @ 中 ， 字 体 颜 色 和 阴影 颜色 是 相同 的 。 此 
外 ， 还 可 以 指定 通过 android: alpha 属 性 指定 透明 度 。 


修改 android: shadowDx 和 android: shadowDy 属 性 的 值 可 以 改变 阴影 与 文本 之 间 的 偏 移 。 措 定 android: 
shadowRadius 属 性 可 以 让 用 户 产 生 一 种 文本 更 亮 的 错觉 。 为 了 产生 一 种 友 亮 的 效果 ， 我 们 没有 使 用 android: shadowDx 和 
android: shadowDy 属 性 ， 而 是 通过 中 修改 android: shadowRadius 属 性 的 值 ， 使 日 期 的 文本 内 容 看 起 来 更 亮 一 些 。 


11.1 概要 


让 应 用 程序 看 起 来 很 棒 ， 是 在 Market 上 获得 用 户 好 评 的 最 好 万 法 。 大 多 数 情 况 下 ， 修 饰 应 用 程序 界面 会 多 写 一 些 代 码 ， 但 
是 这 是 值得 的 。 此 外 ， 在 文本 中 使 用 阴影 很 简单 ， 却 可 以 使 应 用 程序 界面 看 起 来 更 专业 。 试 试 这 个 扩 巧 吧 ， 你 不 会 后 悔 的 。 


11.2 “外 部 链接 


http://www.styleseven.com/php/get product.php?product=Digital-7 


http:;//developer.android.com/reference/android/widget/TextView.html 


Hack 12 为 背景 添加 贺 角 边框 
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当 需 要 为 应 用 程序 Ul 控 件 选择 育 景 的 时 候 ， 开 妈 者 通 冲 会 使 用 图 片 。 通 单 情况 下 ， 开 友 者 会 添加 目 定 义 颜 色 和 形状 来 蔡 代 
系统 默认 样式 。 


圆 角 边框 是 一 种 看 起 来 很 不 销 的 效果 ， 开 妈 者 只 需要 添加 几 行 代码 融 可 以 在 应 用 程序 中 使 用 这 种 效果 。 


我 们 以 一 个 Hello World 的 示例 程序 为 例 ， 分 析 如 何在 应 用 程序 中 添加 一 个 带 圆 角 边 框 的 灰色 Button。 程 序 的 最 终 效 果 如 图 
12-1 所 示 : 


Hello World, MainActivi 





图 12-1 角 边 框 的 Button 
首先 ， 需 要 在 布局 文件 中 添加 一 个 Button 控 件 ， 使 用 的 XML 文件 如 下 所 示 : 


«Button android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Gstring/hello" 
android:textColor-"4£000000" 
android:padding-"10dp" 
android:background-"QGdrawable/button rounded background"/» 


由 以 上 文件 可 知 ， 我 们 并 没有 使 用 任何 特殊 属性 。 我 们 只 是 为 背景 属性 指定 了 drawable 值 ， 但 是 这 个 值 不 是 一 个 图 片 ， 而 
是 一 个 XML 文件 。 在 drawable 值 指定 的 XML 文件 中 有 一 个 ShapeDrawable 对 象 ， 该 对 象 是 一 个 可 绘制 对 象 ， 可 以 用 来 绘制 各 
种 原始 形状 ， 例 如 方块 等 。ShapeDrawable 对 应 的 XML 文件 如 下 所 示 : 


«shape xmlns:android-"http://schemas.android.com/apk/res/android" 
android:shape-"rectangle"» 
«solid android:color-2"£AAAAAA"/» 
«corners android:radius-"15dp"/» 

-«/shape» 


除了 radius 属 性 ， 我 们 还 定义 了 <shape/> 标 签 ， 并 且 使 用 <solid/> 标 签 为 Button 指 定 了 要 填充 的 颜色 值 ， 使 用 
<corners/> 标 签 将 边框 指定 为 豆角 。 还 有 其 他 属性 没有 在 本 例 中 使 用 到 ， 有 兴趣 的 读者 可 以 参照 开发 文档 ( 见 12.2 节 ) 了 解 这 


12.1 概要 


ShapeDrawablezé—^^73U H2 4E ZSTDSSBUEE LE AARIA FAENA RAE iexUOHILAfrListView. E 
试用 这 个 扩 巧 ， 这 样 会 使 应 用 程序 看 起 来 更 专业 。 


12.2 ”外 部 链接 


http:;//developer.android.com/guide/topics/resources/drawable-resource.html*Shape 


Hack 13 在 onCreate () 方法 中 获取 View 的 宽度 和 高 度 
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如 果 需 要 开 友 一 些 依赖 于 Ul 控 件 的 宽 和 高 的 功能 ， 开 发 者 可 能 会 用 到 View 的 getHeight () 和 getWidth () 方法 。 对 于 新 
手 来 说 ， 这 里 有 一 个 小 陷阱 值得 注意 : 试图 在 Activity 的 onCreate () 方法 中 获取 控件 的 宽 和 高 。 遗 憾 的 是 如 果 开 发 者 在 
onCreate () 方法 中 调用 上 述 万 法 ,会 友 现 返回 值 都 是 0。 本 章 我 会 向 读者 介绍 一 种 避 开 这 个 陷阱 的 方法 。 


首先 分 析 为 什么 在 Activity 的 onCreate () 方法 中 读 取 视图 的 尺寸 会 返回 0 值 。 当 onCreate () 方法 被 调用 时 ， 会 通过 
Layoutin.ater 将 XML 布 局 文件 填充 到 ContentView。 填 充 过 程 只 包括 创建 视图 ， 却 不 包括 设置 其 大 小 。 那 么 ， 视 图 的 大 小 是 在 
何 时 指定 的 呢 ? 


Android 开 发 文档 ( 见 13.2 节 ) 的 解释 如 下 所 示 : 


“绘制 布局 由 两 个 痪 历 过 程 组 成 : 测量 过 程 和 布局 过 程 。 测 量 过 程 由 measure (int, int) 方法 完成 ， 访 方法 从 上 到 下 通 历 
视图 树 。 在 递归 遍历 过 程 中 ， 每 个 视图 都 会 同 下 层 传递 尺寸 和 规格 。 当 measure 方 法 遍历 结束 时 ， 每 个 视图 都 保 仓 了 各 目的 尺 
十 信息 。 第 二 个 过 程 由 layout (int, int, int, int) 方法 完成 ， 访 方法 也 是 由 上 而 下 通 历 视图 树 ， 在 遍历 过 程 中 ， 每 个 父 视图 通 
过 测量 过 程 的 结果 定位 所 有 子 视图 的 位 置信 息 。” 


结论 如 下 : 只 有 在 整个 布局 绘制 完毕 后 ， 视 图 才能 得 到 上 自身 的 高 和 和 过， 这 个 过 程 友 生 在 onCreate () 方法 之 后 ， 因 此 , 在 
此 之 前 调用 getHeight () 和 getWidth () 方法 返回 的 结果 都 是 0。 


把 XML 布局 文件 比喻 成 蛋糕 食 谐 : Layoutlnflater 类 融 是 购买 所 有 食材 的 人 ; 测量 和 布局 的 过 程 残 是 蛋糕 师 的 工作 ， 最 终 的 
视图 融 是 香料 本 身 。 人 在 onCreate () 阶段 ， 只 是 购买 了 制作 和 归 糙 的 食材 ， 但 是 仅仅 知道 食材 是 不 足以 预知 和 电 糙 最 终 大 小 的 。 


开 上 友 者 可 以 使 用 View 的 post () 方法 解决 上 述 问题 。 访 万 法 接收 一 个 Runnable 绪 程 参数 ， 并 将 其 添加 到 消息 队列 中 。 有 趣 
的 是 Runnable 线 程 会 在 UI 线程 中 执行 。 使 用 post () 方法 的 源码 如 下 所 示 : 


protected void onCreate (Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


View view - findViewById(R.id.main my view); 布局 绘制 后 获取 
view.post(new Runnable() ( <4 View 的 大 小 

aOverride 

public void run() ( 正确 的 宽 和 高 


Log.d(TAG, "view has width: "-«view.getWidth() + 一 
' and height: "-view.getHeight()); 


13.1 概要 


Android 源 代码 中 很 多 模块 都 使 用 了 post () 方法 ， 该 方法 并 不 仪 限于 获取 视图 的 宽 和 高 。 如 果 读 者 分 析 过 View 类 的 源 代 
码 ， 并 搜索 过 post 天 键 词 ， 你 会 惊讶 调用 post () 方法 的 地 方 竟然 如 此 之 多 。 深 入 理解 框 絮 层 运行 机 制 对 于 避 开 类 似 于 本 例 中 
的 小 陷阱 是 很 重要 的 。 最 后 ， 还 是 那 句 话 ， 理 解 它 的 用 处 ,不 要 滥用 它 。 


13.2 ”外 部 链接 


http://source.android.com/source/downloading.html 


http:;//developer.android.com/guide/topics/ui/how-android-draws.html 


Hack 14 VideoView 的 转 屏 处 理 技巧 
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为 应 用 程序 添加 视频 是 提供 丰富 用 户 体验 的 好 方法 。 我 曾 见 过 使 用 包含 视频 的 化 式 图 展示 公司 信息 的 应 用 程序 。 有 时 ， 在 复 
杂 视 图 中 使 用 视频 展示 信息 是 一 个 简单 方法 ， 这 样 残 不 需要 编写 动画 效果 的 逻辑 代码 了 。 

我 注意 到 ， 当 观看 视频 时 ， 用 户 往往 训 欢 切换 到 横 屏 模式 。 因 此 ， 在 这 个 Hack 里 ， 我 会 癌 读 者 展示 当 屏 幕 旋 转 时 ， 如 何 使 


视频 全 屏 显示 。 


e 


要 实现 上 述 功能 ， 需 要 告诉 系统 ， 转 屏 操作 的 处 理 过 程 由 我 们 目 己 来 完成 。 当 屏幕 旋转 后 ， 我 们 会 更 改 VideoView 的 大 小 


首先 ， 为 Activity 创 建 布局 文件 。 在 这 个 Hack 里 ， 我 们 创建 的 布局 文件 由 上 下 两 部 分 组 成 ， 并 以 一 条 横 线 分 割 这 两 部 分 。 上 
面 的 部 分 左 侧 显示 一 个 稍 小 的 文本 ， 右 侧 显 示 一 个 视频 ; 下 面 的 部 分 显示 一 长 段 摘 述 信息 。 当 创建 显示 视频 的 视图 时 ， 我 并 没有 
使 用 VideoView 控 件 ， 而 是 以 一 个 白色 背景 的 视图 控件 蔡 代 。 我 会 使 用 这 个 视图 控件 的 大 小 和 位 置 来 正确 设置 VideoView 控 件 
的 位 置 。 读 者 可 以 在 图 14-1 中 看 到 该 布局 文件 的 最 终 效果 。 


Lorem ipsum dolor sit 
amet, consectetur 
adipiscing elit, Sed non 
metus et ligula dignissim 
imperdiet vitae nec diam. 
Fusce sit amet lorem 
quam, STET 


E rr m E | k | m A 


Quisque ultrices est justo, non aliquet libero. 
Quisque vel enim eget tellus rhoncus condimentum 
sed non metus. Aenean et venenatis lorem. Sed 
ultricies felis eu ligula varius ac fermentum sapien 


consectetur. [nteger nisl lorem, tincidunt 
elementum pharetra in, porttitor sed erat. Etiam 
ante risus, gravida sed ultricies vel, accumsan eu 
metus. Donec interdum, mi eget tincidunt 
adipiscing, purus lorem blandit elit, commodo 
enenatis turpis arcu vel nisi. Aliquam aliquam nisl 
non sem congue blandit. Quisque ultrices est justo, 
non aliquet libero. Quisque vel enim eget tellus 
rhoncus condimentum sed non metus. Aenean et 
venenatis lorem. Sed ultricies felis eu ligula varius 
ac fermentum sapien consectetur. Integer nisl 
lorem, tincidunt elementum pharetra in, porttitor 
sed erat. Etiam ante risus, gravida sed ultricies vel, 
accumsan eu metus, Donec interdum, mi eget 





tincidunt adipiscing, purus lorem blandit elit, 
commodo venenatis turpis arcu vel nisi. Aliquam 
aliquam nisl non sem congue blandit. 





图 14-1 ”最终 布局 


从 图 14-2 中 ， 可 以 看 出 视图 树 的 创建 方式 。VideoView 控 件 直接 挂 在 根 视图 下 ， 并 且 与 Portrait Content[1] 控 件 处 于 相同 的 
层级 。 将 VideoView 控 件 放置 在 这 个 位 置 的 用 意 是 : 在 屏幕 旋转 时 ， 既 不 需要 创建 两 个 不 同 的 布局 ， 也 不 需要 修改 VideoView 
的 父 视图 就 可 以 更 改 VideoView 的 大 小 和 位 置 。 另 外 ， 那 个 白色 背景 的 视图 则 命名 为 portrait position[ 半 ， 位 于 视图 树 中 较 深 的 
位 置 。 


ScrollView TextView 
@43773a70 @43774320 


10 Views 
Measure: n/a 
Layout: n/a 
Draw: n/a 


LinearLayout View 
(043773580 (043776650 
id/main portrait content id/main portrait position 


0 1 





View 
(943776fc0 


LinearLayout 
(043773260 
id/main portrait content 


0 














RelativeLayout 
(043772b88 





ScrollView TextView 
(943777110 (0437775c8 





VideoView 
(043778428 
id/main videoview 


图 14-2 ”视图 树 


现在 我 们 有 了 布局 文件 ， 束 可 以 编写 Activity 的 源码 了 。 首 先 ， 要 让 Activity 能 够 处 理 转 屏 操作 。 要 实现 这 个 功能 ， 需 要 在 
AndroidManifest.xml 文 件 中 相应 的 <Activity> 标 签 中 添加 android: configChanges="orientation" 属 性 。 配 置 该 属性 后 ， 当 
屏幕 旋转 时 ， 系 统 不 会 重启 Activity， 而 是 调用 该 Activity 的 onConfigurationChanged () 方法 。 


当 屏 幕 的 方向 改变 后 ， 丈 需要 改变 视频 的 大 小 和 位 置 。 我 们 通过 一 个 名 为 setVideoViewPosition () 的 私有 方法 完成 这 个 


功能 ， 其 源码 如 下 所 示 : 


private void setVideoViewPosition() ( Ja] p 24 
if (getResources().getConfiguration().orientation -- Ri t Z 
ActivityInfo.SCREEN ORIENTATION PORTRAIT) ( < Be Pit ER 


> mPortraitContent.setVisibility (View.VISIBLE); 


int[] locationArray - new int[2]; © videoView 
e mPortraitPosition.getLocationOnScreen(locationArray); «eA 的 位 置 


使 mPortrait- 
RelativeLayout.LayoutParams params = 
Content 可 视 


new RelativeLayout.LayoutParams (mPortraitPosition.getWidth ( 
mPortraitPosition.getHeight()); 


params.leftMargin = locationArray[0]; 
params.topMargin = locationArray[1]; 设置 videoView 
| | x v 
mVideoView.setLayoutParams (params) ; i 的 布局 参数 
) else { © 隐藏 mPortrait- 
mPortraitContent.setVisibility(View.GONE); «j Content 


RelativeLayout.LayoutParams params - 
new RelativeLayout.LayoutParams (LayoutParams.FILL PARENT, 


LayoutParams.FILL, PARENT); roc ; 
设置 videoView 
params.addRule(RelativeLayout.CENTER IN PARENT); 的 布局 参数 
mVideoView.setLayoutParams (params); c 


) 


如 人 @@ 中 所 示 ，SsetVideoViewPosition () 方法 分 为 两 个 分 广 ， 分 别 对 应 坚 屏 配置 和 横 屏 配置 。 在 坚 屏 配置 的 情况 下 ， 首 先 
在 @ 中 令 portrait content 可 视 。 因 为 在 这 种 情况 下 ，videoView 和 日 色 背 景 的 视图 具有 相同 的 大 小 和 位 置 ， 因 此 在 @ 中 ， 获 取 
日 色 背 景 视图 的 位 置信 息 ， 并 在 @ 中 将 其 设置 为 videoView 的 布局 参数 。 


横 屏 分 支 的 情况 与 上 述 类 似 。 首 先 ， 在 旬 中， 隐藏 portrait content; 然后 创建 一 个 布局 参数 使 videoView 可 以 全 屏 显 示 ; 
最 后 ， 在 @ 中 ， 将 该 布局 参数 设置 给 videoView。 





译 者 注 
译 者 注 


[1] 指 的 是 ID 为 main_pottrait_content 的 LineatLayout。 





[2] 4& $7 XX ID 7] main, portrait position 的 View 控 件 。 


14.4 概要 


正如 我 在 本 Hack 开 始 时 提 到 的 ， 视 频 对 于 丰富 应 用 程序 内 容 是 很 有 用 的 。 开 发 者 可 能 知道 当 视 频 大 小 改变 时 ， 默 认 的 
videoView 类 会 维持 屏幕 宽 高 比 ， 如 果 你 想 让 视频 填充 整个 可 用 控件 ， 就 需要 履 盖 自 定 义 视 图 中 的 onMeasure () 方法 。 


14.2. MiB 


http://developer.android.com/guide/topics/resources/runtime-changes.html 


Hack 15 ” 移 除 背景 以 提升 Activity 启 动 速度 
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Android SDK 中 提供 了 Hierarchy Viewer 工 具 ， 该 工具 可 以 用 来 检测 未 航 使 用 的 视图 以 减少 视图 树 的 层次 。 如 果 开 上 友 者 通 


过 该 工具 浏览 一 颗 视 图 树 ， 会 发 现 许 多 不 可 控 的 节点 。 在 这 个 Hack 里 ， 我 们 来 看 看 这 些 节点 是 什么 以 及 如 何 微调 它们 来 提升 
Activity 的 启动 速度 。 


如 果 读 者 创建 一 个 默认 应 用 程序 ， 并 运行 该 程序 ， 会 看 到 与 图 15-1 类 似 的 界面 。 如 果 此 时 运行 HierarchyViewer 工 具 查看 该 
Activity， 会 看 到 与 图 15-2 类 似 的 界面 。 我 们 需要 削减 视图 树 的 层次 。 


Hello World, BackgroundTestActivity! 


图 15-1 Sc Android g Jf 1$ 75 





PhoneWindowSDecorView LinearLayout FrameLayout TextView 
(943773260 (043771498 (04377 1ddO (043772510 


id/ 22 


FrameLayout LinearLayout LinearLayout 
@43773758 (043773c18 (043773e70 
id/content id/content 





图 15-2 Hierarchy Viewer X zr 8 View 4] 


首先 ， 通 过 移 除 标 题 栏 来 减少 一 些 节 后。 标题 栏 就 是 界面 上 方 那个 显示 “BackgroundTest” 的 灰 条 ， 它 由 一 个 
FrameLayout 容 器 和 一 个 TextView 控 件 组 成 。 可 以 通过 在 res/values 目 录 下 创建 theme.xml 文 件 来 删除 上 述 节点 。 源 码 如 下 所 


ZR: 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 
«style name-"Theme.NoBackground" parent-"android:Theme"-» 
«item name-"android:windowNoTitle"»true«c/item» 
</style> 
</resources> 


可 以 通过 修改 Androidmanifest.xml 中 的 <application> 标 签 ， 并 添加 android: 
theme="@style/Theme.NoBackground" 属 性 来 使 用 这 个 主题 。 此 时 ， 重 新 运行 应 用 程序 ， 标 题 栏 束 消 失 了 ， 其 View 树 如 图 
15-3HTzn. 


PhoneWindowS$DecorView FrameLayout LinearLayout TextView 
(043770cc0 (043771560 (043772218 (043772700 


id/content 





图 15-3 ”无 标题 栏 时 ，Hietatchy Viewer X. z& 869 Views] 
读者 已 经 知道 LinearLayout 和 TextView 是 什么 了 ， 那 么 PhoneWindow$DecorView 和 FrameLayout 又 是 什么 呢 ? 


FrameLayout 是 在 执行 setContentView () 方法 时 创建 的 ，DecorView 是 视图 树 的 根 节 点。 默认 情况 下 ， 框 以 层 会 以 默认 
背景 色 填 充 窗 口 ， 而 DecorView 束 是 持 有 窗口 背景 图 片 的 视图 。 如 果 使 用 不 透明 的 界面 或 者 自 定 义 背 景 ， 那 么 绘制 默认 背景 色 
Bic ETE SRI]. 


如 果 确 信和 要 在 Activity 中 使 用 不 透明 的 用 尸 界面 ， 束 可 以 移 除 默认 背景 以 加 快 Activity 局 动 时 间 。 要 实现 这 个 功能 ， 需 要 在 先 
前 的 主题 中 添加 一 行 代码 。 修 改 后 的 代码 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 
«style name-"Theme.NoBackground" parent-"android:Theme"-» 
«item name-"android:windowNoTitle"»truec/item» 
«item name-"android:windowBackground"»Gnull«/item» 
</style> 
</resources> 


15.1 概要 


移 除 窗 口 默认 背景 是 提升 应 用 程序 启动 速度 的 一 个 简单 技巧 。 判 断 是 否 需 要 移 除 背 景 的 原则 很 简单 : 如 果 应 用 程序 界面 需要 
占据 窗口 100% 的 空间 ， 就 需要 将 windowBackground 属 性 设置 为 null。 记 住 ， 主 题 既 可 以 在 <application> 标 签 中 设置 ， 也 可 


以 在 <activity> 标 签 中 设置 。 


15.2 “外 部 链接 


http://developer.android.com/guide/developing/debugging/debugging-ui.htmlHierarchyViewer 


http://stackoverflow.com/questions/6499004/androidwindow-background-null-to-improve-app-speed 


Hack16 ”更 改 Toast 显 示 位 置 的 技巧 


Android v1.0 十 


在 Android 中 ， 如 果 开 发 者 需要 通知 用 户 发 生 了 什么 事情 ， 可 以 使 用 Toast 这 个 类 。Toast 是 一 种 弹出 式 通 知 ， 通 党 在 屏幕 下 
方 中 间 位 置 显示 一 行文 本 。 如 果 读 者 从 未 见 过 Toast， 可 以 看 看 图 16-1， 在 该 图 中 ，Toast 就 是 那个 显示 “This alarm is set for 
17 hours and 57 minutes from now.” 的 黑色 的 方 框 。 


Tis alarm ls set for 17 hours and 57 
minutes from now. 


9:UU- 





图 16-1 闹钟 应 用 程序 中 的 Toast 例 子 
使 用 API 创 建 一 个 Toast 是 非常 简单 的 ， 假 如 要 创建 一 个 显示 “Hi! ”的 Toast， 只 需要 编写 以 下 几 行 代码 : 
Toast.makeText(this, "Hi!", Toast.LENGTH SHORT).show(); 
Toast 类 提供 的 接口 很 不 灵活 。 例 如 ， 对 于 Toast 显 示 时 间 的 参数 ， 开 友 者 仪 仅 可 以 从 Toast.LENGTH_ SHORT 和 
Toast.LENGTH_LONG 中 选择 。 虽 然 Toast 的 变化 很 少 ， 但 是 仍然 可 以 改变 Toast 弹 出 的 位 置 。 


根据 应 用 程序 布局 的 不 同 ， 开 发 者 可 能 需要 将 Toast 显 示 在 其 他 人 位置， 比如， 在 指定 视图 的 顶部 显示 一 个 Toast。 让 我 们 看 
看 如 何 创建 一 个 Toast， 并 使 其 在 不 同 的 位 置 显示 。 请 看 图 16-2 所 示 的 例子 ， 在 这 个 例子 中 ， 我 们 定义 了 4 个 Button， 分 别 分 布 
在 界面 的 四 角 上 。 当 点 击 Button 时 ,会 在 Button 所 在 位 置 的 角落 里 显示 一 个 Toast。 





show toas! show toas! 





图 16-2 在 不 同位 置 显示 的 Toast 
要 将 Toast 移 动 到 屏幕 其 他 地 方 ， 束 需要 以 不 同 的 方式 创建 Toast。Toast 中 有 一 个 公共 方法 ， 其 方法 签名 如 下 : 


public void setGravity(int gravity, int xOffset, int yOffset); 


要 显示 图 16-2 中 所 示 的 Toast， 需 要 使 用 如 下 代码 : 


Toast toast - Toast.makeText(this, "Bottom Right!", 本 一 一 创建 Toast 
Toast.LENGTH SHORT); 


toast.setGravity(Gravity.BOTTOM | Gravity.RIGHT, 0, 0); «| 


. YL BO . 
LX BE. gravit 
toast.show(); S y 


属性 ， 以 改 
变 默认 位 置 


16.1 概要 


虽然 这 个 Hack 看 起 来 返 简 单 ， 但 是 很 多 Android 开 发 者 并 不 知晓 本 例 的 解决 方案 。 当 界面 锐 分 成 不 同 的 Fragment， 并 且 希 
望 Toast 显 示 在 指定 的 位 置 ， 开 上 及 者 融会 友 现 更 改 Toast 的 位 置 是 很 有 用 的 。 


16.2 ”外 部 链接 


http:;//developer.android.com/guide/topics/ui/notifiers/toasts.html 


Hack 17 使 用 Gallery 创 建 向 导 表 单 


Android v2.1+ 


当 需 要 用 户 填 充 一 个 较 长 的 表单 (form) 时 ， 开 友 者 或 许 会 找 不 到 头绪 。 开 友 者 的 目的 可 能 是 需要 创建 一 个 用 户 注 册 表 
单 ， 或 者 是 需要 应 用 程序 通过 表单 上 传 一 些 数据 。 在 其 他 平台 ， 开 友 者 可 以 创建 同 导 表 单 (wizard form) 满足 上 述 需 求 ， 这 种 
表单 可 以 把 表单 项 分 割 到 不 同 的 视图 中 。 但 是 Android 平 台 没 有 提供 类 似 控件 。 在 这 个 Hack 里 ， 我 会 使 用 Gallery 控 件 创建 一 个 
具有 多 个 表单 项 的 用 户 注册 表单 。 最 终 效 果 如 图 17-1 所 示 。 


针对 这 个 例子 ， 在 创建 的 注册 表单 中 ， 用 户 需 要 输入 以 下 信息 : 
` 姓名 


“电子 邮件 


[a og TERICI 





图 17-1 使 用 Gallery 控 件 实现 的 向 导 表 单 





我 们 在 每 个 页 面 显示 两 个 表单 项 ， 因 此 一 共 需 要 4 个 页 面 才能 完全 显示 上 述 信息 。 要 实现 这 个 向 导 表 单 ， 需 要 创建 一 个 命名 
为 CreateAccountActivity 的 Activity。 为 了 让 表单 具备 弹出 窗口 的 式样 ， 我 们 为 上 述 Activity 使 用 Theme.Dialog 样 式 。 在 该 
Activity 中 ， 我 们 会 创建 一 个 Gallery 对 象 ， 并 且 用 一 个 Adapter 填 充 这 个 Gallery。 因 为 该 Adapter 需 要 与 Activity 交 互 ， 因 此 我 们 


使 用 Delegate 委 托 接 口 。 
先 创建 每 个 页 面 的 公用 视图 ，XML 文 件 内 容 如 下 所 示 : 


<?xml version-"1.0" encoding="utf-8"?> 
«RelativeLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 


android:layout width-"270dp" 
android:layout height-"350dp"» 


«LinearLayout android:id-"G-«-id/create account form" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout alignParentTop-"true" 
android:orientation-"vertical" 
android:paddingLeft-"10dp" 
android:paddingTop-"10dp" 
android:paddingRight-"10dp" 
android:background-"£AAAAAAA":- 





在 该 LinearLayout 
中 放置 要 显示 的 表 
单项 


在 LinearLayout 第 
一 个 子 视图 中 显示 
表单 标题 


«TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" <q 
android:text-"Account creation" 
android:textColor-"$000000" 
android:textStyle-"bold" 
android:textSize-"20sp"/» 


«/LinearLayout» 


«Button 
android 


android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


«Button 


android: 
android: 
android: 
android: 
android: 


android 


android: 


i1d="@+id/create account. next" 
layout width-"wrap content" 
layout height-2"wrap content" 
layout alignParentTop-"true" 
layout alignParentRight-"true" 
textSize-"12sp" 
gravity-"center" 

layout marginTop-"10dp" 

layout marginRight-"10dp" 
text-"Next"/» 


id="@+id/create account. create" 

layout width-"fill parent" 

layout height-2"wrap content" 

layout below-"Gid/create account form" 
gravity-"center" 


:paddingRight-"45gdp" 
android: 


text-"Create Account" 
textSize-"12sp"/» 


" Next "TZ £l Hi 
于 切换 到 下 一 个 
页 面 


这 个 按钮 只 在 最 
后 一 个 页 面 显示 ， 
用 于 提交 表单 


</RelativeLayout> 


由 以 上 代码 可 知 ， 我 们 在 布局 中 设置 了 一 个 LinearLayout 作 为 表单 项 的 占 位 符 。 后 续 分 析 中 ， 读 者 就 会 看 到 如 何 通 过 
Gallery 的 Adapter 填 充 它 。 


既然 有 了 公用 视图 的 布局 文件 ， 我 们 就 可 以 创建 Adapter 的 代码 。 我 们 将 该 Adapter 命 名 为 CreateAccountAdapter， 继 承 
自 BaseAdapter。 鉴 于 该 Adapter 的 代码 较 长 ， 这 里 只 分 析 重 要 的 方法 。 第 一 个 要 定义 的 束 是 用 来 与 上 述 Activity 交 互 的 接口 ， 
代码 如 下 所 示 : 


public static interface CreateAccountDelegate { 
int FORWARD = 1; 
int BACKWARD = -1; 


void scroll(int type); 


void processForm(Account account); 


} 


当 用 户 点 击 “Next” 按 钮 时 ， 执 行 scroll () 方法 ; 当 用 户 提交 表单 时 ， 执 行 proccessForm () 万 法 。 当 按钮 被 点 击 时 ， 
需要 访问 委托 接口 (delegate) ， 因 此 我 们 在 getView () 方法 中 设置 点 击 事件 监听 器 。 源 码 如 下 所 示 : 


public View getView(int position, View convertView, ViewGroup parent) { 


convertView - mInflator.inflate( 
R.layout.create account generic row, parent, false); JH 5H 
LinearLayout formLayout - (LinearLayout) convertView Æ X 
.findViewById(R.id.create account form); « 获取 放置 表单 View 
View nextButton = convertView 项 HJ Linear- 
.findViewById(R.id.create account next); Layout 
if (position == FORMS QTY - 1) 1 
nextButton.setVisibility(View.GONE); 
} else { 
nextButton.setVisibility(View.VISIBLE); 最 后 一 页 
} MA: 
不 显 不 
if (mDelegate !- null) { “Next " 





nextButton.setOnClickListener(new OnClickListener() { 3— Wen 


QOverride 
public void onClick(View v) { 


mDelegate.scroll(CreateAccountDelegate.FORWARD); 


I 
) 


Button createButton - (Button) convertView 4X. TE. 

i ] ， | 又 

.findViewById(R.id.create account create); I 

if (position == FORMS QTY - 1) { 后 一 页 

createButton.setOnClickListener(new OnClickListener() ( < 显示 该 
QOverride 按钮 


public void onClick(View v) { 
processForm(); 
) 
)):; 


createButton.setVisibility(View.VISIBLE); 
} else ( 
createButton.setVisibility(View.GONE); 
} 


switch (position) { 最 后 一 步 ， 根据 
case 0: | 页 面 位置 十 充 
populateFirstForm(formLayout); 
LinearLayout 
break; 


) 


return convertView; 


populateFirstForm () 方法 用 于 创建 姓名 和 标题 这 两 个 表单 项 ， 并 将 其 添加 到 LinearLayout 中 。 在 示例 程序 中 ， 我 通过 代 
码 实现 上 述 逻 辑 ， 但 是 读者 也 可 以 通过 填充 XML 布 局 文件 的 方式 实现 。 


还 有 一 个 模块 没有 讲 到 ， 那 残 是 谁 来 实现 CreateAccount-Delegate 接 口 。 在 本 例 中 ， 我 们 使 用 CreateAccountActivity 实 


CreateAccountActivity 用 于 跟踪 用 户 当 前 所 在 的 页 面 ， 并 处 理 页 面 跳 转 的 逻辑 。 源 码 如 下 所 示 : 


public class CreateAccountActivity extends Activity implements 
CreateAccountDelegate ( 


private Gallery mGallery; 
private CreateAccountAdapter mAdapter; 
private int mGalleryPosition; 


QOverride 
protected void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 


setContentView(R.layout.create account); 
mGallery = (Gallery) findViewById(R.id.create account gallery); 


mAdapter - new CreateAccountAdapter(this); 在 onCreate() 方法 中 创建 
mGallery.setAdapter (mAdapter); , 
Adapter, Jf Xf Hi B 


mGalleryPosition - 0; 
) Gallery 
QGOverride 
protected void onResume() { 在 onResume() 方法 中 将 当 


super.onResume(); EPA 2 91 ML i 
mAdapter.setDelegate(this); Hj Activity Ix Pi. 7J Adapter 


) 的 委托 ， 并 且 在 onPause() 
方法 中 将 该 委托 置 空 


QGOverride 

protected void onPause() ( 
super.onPause(); 
mAdapter.setDelegate (null); 

} 


@Override 
public void onBackPressed() { 重 73 Activity 的 onBack- 
if (mGalleryPosition > 0) ( Pressed) Jj $, MFR 
scroll (BACKWARD) ; 回 上 一 个 页 面 
) else ( 


super.onBackPressed(); 


) 
在 scroll() 7r P, Activity 可 
ui^ uoi | 以 根据 参数 将 Gallery 移动 到 
public void scroll(int type) { 
下 一 个 页 面 或 者 上 一 个 页 面 中 
switch (type) { 
case FORWARD: 
if (mGalleryPosition < mGallery.getCount() - 1) { 
mGallery.onKeyDown(KeyEvent.KEYCODE DPAD RIGHT, 
new KeyEvent(0, 0)); 
mGalleryPosition-4-*; 


break; 


遗憾 的 是 ， 我 们 无 法 为 Gallery 控 件 的 页 面 切 损 添加 动画 效果 。 我 想到 的 唯一 方法 是 友 送 
KeyEvent.KEYCODE_DPAD_RIGHT 事 件 ， 虽 然 这 是 投机 取 巧 ， 却 还 管用 。 


CreateAccountActivity 中 其 他 代码 用 于 验证 数据 和 错误 处 理 。 这 些 代码 并 无 特别 之 处 ， 因 此 留 给 读者 目 己 阅读 。 


17.1 概要 


使 用 Gallery 控 件 创建 向 导 表 单 可 以 简化 用 尸 填 写 较 长 表单 的 流程 。 将 表单 项 放 在 不 同 页 面 中 ， 并 且 利 用 Gallery 控 件 的 默认 
动画 添加 悦目 的 效果 ， 可 以 使 用 尸 在 填写 表单 的 过 程 中 更 愉悦 些 。 


根据 需要 ， 读 者 也 可 以 使 用 ViewPager 开 发 相同 的 功能 ， 只 是 其 Adapter 返 回 的 不 是 View 而 是 Fragment。 


17.2 ”外 部 链接 


http:;//developer.android.com/reference/android/widget/Gallery.html 


第 4 章 ” 买 用 工具 


本 章 介绍 开 友 Android 应 用 程序 时 用 到 的 两 个 实用 工具 。 


Hack 18 在 友 布 正式 人 唉 本 前 移 除 日 志 语 名 


Android v1.0 十 


如 果 应 用 程序 需要 向 服务 器 发 送 请 求 ， 开 友 者 可 能 会 打印 一 些 日 志 来 检查 请 求 是 否 成 功 。 进 憾 的 是 ， 这 些 日 志 语 句 会 存在 于 
最 终 编 译 出 来 的 APK (Android 应 用 程序 包 ) 文件 中 。 移 除 这 些 日 志 对 于 保持 Logcat 输 出 的 清晰 整洁 是 很 重要 的 。 此 外 ， 在 代码 


中 留 下 过 多 日 志 也 会 暴露 一 些 开发 者 不 想 港 露 的 敏感 信息 。 在 这 个 Hack 里 ， 我 会 向 读者 展示 从 正式 版 本 (Market Release) 中 
+a 
AE 


开 友 者 通 冲 都 有 目 己 喜好 的 技术 手段 从 正式 版 本 中 移 除 日 志 。 这 尝 方 法 会 用 到 类 似 下 面 的 代码 : 


if (BuildConfig.DEBUG) LOG.d(TAG, "The log msg"); 


我 认为 ， 移 除 日 志 的 最 佳 万 法 是 使 用 ProGuard 工 具 。 如 果 读 者 从 未 使 用 过 ProGuard， 那 么 我 束 引 用 Android 开 友 文 档 ( 见 
18.275) 的 一 段 话 介绍 这 个 工具 : 


ProGuatd 可 以 移 除 无 用 代码 ， 或 者 使 用 语义 模糊 的 名 称 来 重 命名 类 、 变 量 和 方法 ， 以 此 达到 压缩 、 优 化 和 混淆 代码 的 目 
的 。 这 样 ， 生 成 的 APK 体 积 更 小 ， 并 且 更 不 易 被 北向 工程 (Reverse Engineer) 。 ^ 


不 知道 读者 注意 到 没有 ， 当 编译 Android 应 用 程序 的 时 候 ， 我 们 可 以 在 项 目 根 目录 找到 一 个 名 为 proguard.cfg 的 文件 。 有 了 
这 个 文件 ， 并 不 意味 着 ProGuard 的 功能 默认 是 生效 的 ， 我 们 还 需要 开局 这 项 功能 。 季 运 的 是 ， 开 局 该 功 能 的 方法 比较 简单 : 需 
要 在 项 目 根 目 录 的 default.properties 文 件 中 添加 如 下 代码 : 


proguard.config-proguard.cfg 


现在 ，ProGuard 的 功能 就 生效 了 。 但 是 ， 该 功能 只 在 导出 签名 版 的 APKL 时 才 起 作用 。 为 了 移 除 日 志 ， 还 需要 在 
proguard.cfg 文 件 中 添加 必要 的 代码 。 要 添加 的 代码 如 下 所 示 : 


-assumenosideeffects class android.util.Log { 
public static *** 01...) 


上 述 代码 告诉 ProGuard: 移 除 所 有 使 用 android.util.Log 类 中 d () 方法 的 地 方 ， 不 管 这 个 方法 的 参数 和 返回 类 型 是 什么 。 
这 个 配置 与 Log 类 的 d () 方法 匹配 ， 因 此 所 有 调试 日 志 都 会 被 移 除 。 


[1] 按照 ADT 插 件 后 ， 选 定 项 目 ， 右 击 ， 选 择 Andtoid Tools Export Android Application 。 





译 者 注 


18.1 概要 


ProGuard 工 具 提 供 了 另外 一 种 “润色 ”应 用 程序 正式 版 本 的 方法 。ProGuard 可 能 会 移 除 源码 ， 所 以 开发 者 必须 确认 目 己 
已 经 读 代 了 ProGuard 的 用 户 手册 ， 并 且 为 项 目 创建 了 正确 的 配置 文件 。 此 外 ， 开 发 者 还 需要 考虑 移 除 的 源码 是 否 是 应 用 程序 正 
常 执行 所 必须 的 。 如 果 应 用 程序 运行 异常 ， 请 检查 ProGuard 配 置 文件 中 是 否 保留 了 所 有 必需 的 代码 。 


注意 ，ProGuard 并 不 仅仅 用 于 移 除 日 志 语 句 。 当 测试 程序 时 ， 我 通常 会 在 Activity 中 创建 一 些 方法 来 填充 表单 (Form) , 
我 同样 使 用 ProGuard 移 除 这 些 方法 。 


18.2 ”外 部 链接 


http:;//proguard.sourceforge.net/ 
http://developer.android.com/tools/help/proguard.html 


http:;//mng.bz/ZR3t 


Hack 19 ”使 用 Hierarchy Viewer 工 具 移 除 不 必要 的 视图 
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Android SDK 中 提供 了 许多 实用 工具 ， 其 中 之 一 便 是 Hierarchy Viewer。 这 个 工具 可 以 用 来 查看 视图 树 (View Tree) 并 分 
析 视 图 树 中 各 个 视图 在 测量 、 布 局 、 绘 制 阶段 所 消耗 的 时 | 间 。 通 过 该 工具 提供 的 信息 ， 开 友 者 可 以 找 出 视图 树 中 那些 不 必要 的 视 
图 以 及 性 能 瓶颈 。 在 这 个 Hack 里 ， 我 会 分 析 碍 找 并 解决 上 述 问题 的 方法 。 


注意 : 我 并 不 打算 解释 如 何 使 用 Hierarchy Viewet 工 具 本 身 。 此 ， 开 始 学 习 前 ， 读 者 或 许 需 要 通过 Android 开 发 文档 学 习 下 
该 工具 的 使 用 方法 ， 地 址 是 http://mng.bz/7ZXl。 


为 了 演示 这 个 Hack， 我 创建 了 一 个 实验 性 质 的 应 用 程序 ， 在 该 程序 中 显示 几 个 执行 比较 慢 的 视图 [1]。 稍 后 ， 我 们 会 使 用 
Hierarchy Viewer 工 具 解 决 这 个 问题 。 本 应 用 程序 只 有 一 个 Activity， 其 界面 如 图 19-1 所 示 ， 其 XML 布局 文件 如 下 所 示 : 


Hello World, MalnActivity! 

























































































Slow Measure 





图 19-1 示例 程序 


«?xml version-"1.0" encoding-"utf-8"?» 


«RelativeLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent"-» 


«TextView 


android:layout width-"fill parent" 
android:layout height-"wrap content" 


android:layout alignParentTop-"true" 
android:text-"Gstring/hello"/» 


«RelativeLayout 


android:id-"QG-«-id/slow container" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true"-» 


«com.test.SlowDrawView 
android:id-"G«id/slow draw" 
android:layout width-"fill parent" 
android:layout height-"30dp" 
android:layout alignParentTop-"true" 
android:background-"££FF0000" 
android:text-"Slow Draw"/» 

«com.test.SlowLayoutView 
android:id-"QG(4id/slow layout" 
android:layout width-"fill parent" 
android:layout height-"30dp" 
android:layout below-"Gid/slow draw" 
android:background-"£$00FF00" 
android:text-"Slow Layout"/» 


«com.test.SlowMeasureView 


android: 
android: 
android: 
android: 
android: 
android: 


1d="@+id/slow measure" 

layout width-"fill parent" 
layout height-"30dp" 

layout below-2"Gid/slow layout" 
background-"i0000FF" 
text-"Slow Measure"/» 


«/RelativeLayout» 


«/RelativeLayout-» 


该 应 用 程序 只 是 对 默认 创建 的 应 用 程序 做 了 一 些小 的 改动 。 在 布局 底部 添加 了 三 个 目 定义 视图 并 且 移 除了 标题 栏 。 


该 应 用 程 


序 运 行 时 ， 执 行 Hierarchy Viewer 会 看 到 如 图 19-2 所 示 的 结果 。 


ufu NI Viewer 
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注意 : 现在 先 别 考虑 PhoneWindow$DecorView 和 Frame-Layout 这 两 个 视图 ， 只 把 它们 当 作 框架 层 添 加 的 视图 节点 即 可 ， 它 们 


是 不 可 修改 的 。 我 们 之 前 在 Hack 15 中 提 到 过 这 两 个 视图 节点 。 


首先 ， 需 要 在 ViewGroup 中 查找 髓 套 的 ViewGroup。 在 本 例 中 ， 我 们 可 以 找到 一 个 设置 了 android: 
layout alignParentTop 属 性 的 TextView; 此 外 ， 还 可 以 找到 一 个 包含 所 有 自 定 义 视 图 并 且 设 置 了 android: 
layout alignParentBottom 属 性 的 RelativeLayout， 也 即 图 中 第 二 个 RelativeLayout。 读 者 还 可 以 看 到 第 二 个 RelativeLayout 中 
有 3 个 用 红色 显示 的 性 能 指示 器 号 ， 表 示 该 RelativeLayout 是 视图 树 中 执行 最 慢 的 视图 。 我 们 尝试 通过 修改 其 他 视图 的 属性 来 删 
除 该 RelativeLayout。 修 改 后 的 XML 布局 文件 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?-» 

«RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 


android:layout height-"fill parent"> 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout alignParentTop-"true" 
android:text-"Gstring/hello"/» 


«com.test.SlowMeasureView 
android:id-"G-id/slow measure" 

android:layout width-"fill parent" 

:layout height-"30dp" 


android: 


android 
layout alignParentBottom-"true" 
background=" #0000FF" 
:text-"Slow Measure"/> 


android: 
android 


«com.test.SlowLayoutView 


android:id-"QG-«*id/slow layout" 


android:layout width-"fill parent" 
android:layout height-"30dp" 
android:layout above-"Gid/slow measure" 


android: 
android: 


android: 
android: 


android 


android: 


android 


background-"£00FF00" 
text-"Slow Layout'"/» 


«com.test.SlowDrawView 


id-"Gc-id/slow draw" 
layout width-"fill parent" 


:layout height-"30dp" 
android: 


layout above-"Gid/slow layout" 
background-"£FF0000" 


:text-"Slow Draw"/» 


«/RelativeLayout» 


最 终 的 修改 方案 减少 了 一 个 视图 节点 ， 降 低 了 视图 树 的 高 度 。 创 建 视图 时 ,一定 要 避免 产生 过 高 的 视图 树 。Android 绘 制 布 
局 由 两 次 遍历 过 程 组 成 : 测量 过 程 和 布局 过 程 。 如 果 视 图 树 有 大 多 节 氮 ， 志 历 该 树 融会 消耗 更 长 时 间 。 


修改 XML 布局 文件 生成 较 低 的 视图 树 层次 后 ， 一 定 要 看 看 性 能 指示 器 。 性 能 指示 器 显示 的 是 当前 视图 与 视图 树 中 其 他 视图 
相 比 的 相对 结果 ， 因 此 不 要 被 该 结果 蒙 否 。 大 部 分 性 能 指示 器 显示 绿色 并 不 表示 这 些 视图 一 定 是 合理 的 ， 此 时 需要 检查 绘制 每 个 
视图 花费 的 时 间 并 确保 一 切 运 行 民 好 。 


[1] 指 的 是 测量 、 布 局 、 绘 制 这 三 个 过 程 比 较 慢 的 视图 。 译 者 注 


[2] 图 19-2 中 显示 的 是 两 个 红色 指示 器 。 在 不 同 执行 条 件 下 ， 该 指示 器 的 顾 色 会 有 所 不 同 。 








译 者 注 


19.1 概要 


Hierarchy Viewer 是 查看 视图 树 的 强大 工具 。 开 发 应 用 程序 上 时， 使 用 该 工具 分 析 视 图 树 的 层次 结构 ， 确 保 当 前 布局 能 生成 
响应 灵敏 的 UI 界面 并 且 使 用 了 最 低 的 树 层次 。 


19.2 ”外 部 链接 


http:;//developer.android.com/guide/developing/debugging/debugging-ui.html 


本 章 分 析 Android 中 可 以 使 用 的 几 种 开发 模式 。 


Hack 20 ”模型 -视图 -主导 器 模式 \ 
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读者 很 可 能 听 说 过 MVCI1] (模型 -视图 -控制 器 ) 模式 ， 并 且 已 经 在 其 他 编程 框架 中 使 用 过 该 模式 。 当 尝试 用 更 优 的 方法 测 
试 Android 代 码 的 时 候 ， 我 发 现 了 MVP[] (模型 -视图 -主导 器 ) 模式 。MVP 模 式 与 MVC 模 式 的 根本 区 别 是 : 在 MVP 模 式 中 ， 
视图 中 的 业务 逻辑 被 放 入 主导 器 中 ， 主 导 器 通过 接口 与 视图 交互 | 

在 这 个 Hack 里 ， 我 会 向 读者 展示 如 何在 Android 中 使 用 MVP 模 式 ， 以 及 如 何 利用 该 模式 提高 代码 的 易 测 性 。 为 了 演示 其 运 
行 机 制 ， 我 会 创建 一 个 启动 画面 。 所 谓 启动 画面 ， 就 是 一 个 普通 的 界面 ， 在 应 用 程序 开始 运行 前 做 一 些 初始 化 和 验证 工作 。 在 本 
例 中 ， 我 们 会 在 启动 画面 中 检查 网 络 连接 是 否 正 常 ， 并 显示 一 个 进度 条 。 如 果 网 络 连接 正常 ， 就 切换 到 另 一 个 Activity 中 ;否则 
便 不 会 切换 到 其 他 Activity， 而 是 向 用 户 显 示 一 条 错误 信息 以 阻止 程序 继续 运行 。 

要 创建 启动 画面 ， 需 要 一 个 负责 在 模型 和 视图 间 交 互 的 主导 器 。 在 本 例 中 ， 主 导 器 有 两 个 功能 : 一 个 功能 用 于 判断 网 络 是 否 
连接 ， 另 一 个 功能 用 于 控制 视图 。 项 目 结构 如 图 20-1 所 示 。 


* (S hack020 


* sre 
Y Hj com.manning.androidhacks.hack020.presenter 
P |J] SplashPresenter.java 
Y £3 com.manning.androidhacks.hack020.presenter.model 
b |J] IConnectionStatus.java 
Y H com.manning.androidhacks.hack020.presenter.model.impl 
> |J) ConnectionStatus.java 
Y H com.manning.androidhacks.hack020.view 
> [J] ISplashView.java 
Y H3 com.manning.androidhacks.hack020.view.impl 
> [J] MainActivity.java 
> [DN SplashActivity.java 
> zB gen [Generated Java Files] 
Y G5 tests 
Y 8j com.manning.androidhacks.hack020.presenter 
> [D SplashTest.java 
> (»$ mockito-all- 1.9.0-rc1.jar 
b mà Unit 4 
b mà Android 1.6 
E> assets 
p d bin 
b Eb libs 
Y C» res 
b (> drawable-hdpi 
P [= drawable-ldpi 
b (2 drawable-mdpi 
Y [Se layout 
(X) splash.xml 
Y (values 
strings.xml 
AndroidManifest.xml 
(3 proguard.cfg 
[3 project.properties 


图 20-1 MVP H 2# 
主导 器 中 会 用 到 一 个 模型 类 ConnectionStatus， 该 类 实现 了 IConnectionsStatus 接 口 ， 该 接口 中 只 定义 了 一 个 判断 网 络 是 
否 在 线 的 方法 。 源 码 如 下 所 示 : 


public interface IConnectionStatus { 
boolean isOnline(); 


读者 可 能 会 意识 到 : 负责 控制 视图 的 代码 位 于 Activity 中 ， 并 且 这 个 Activity 实 现 了 IlSplashView 接 口 。 主 导 器 会 通过 该 接口 
控制 应 用 程序 的 执行 流程 。ISplashView 接 口 的 源码 如 下 所 示 : 


public interface ISplashView ( 
void showProgress(); 
void hideProgress(); 
void showNoInetErrorMsg(); 
void moveToMainView(); 


因为 我 们 是 在 Android 平 台 上 开发 应 用 程序 ， 因 此 首先 需要 创建 视图 ， 然 后 我 们 会 把 视图 的 控制 权 交 给 主导 器 。 代 码 如 下 所 
7R: 


public class SplashActivity extends Activity implements ISplashView { 
private SplashPresenter mPresenter; 


Q^ctivity 8$ 


QOverride 

public void onCreate(Bundle savedInstanceState) ( 始 化 代码 
mPresenter = new SplashPresenter(); gis 为 当前 Activity 初 
mPresenter.setView(this); nol 

) O 始 化 主导 器 

QOverride 

protected void onResume() { 15 ff onResume() Jr i& 


HF, HÍT EFINI 


super.onResume(); 
mPresenter.didFinishLoading(); < 


) 


首先 ， 需 要 初始 化 Activity@ 四 ， 然 后 创建 用 于 完成 所 有 交互 操作 的 主导 器 @， 并 将 当前 Activity 设 置 给 主导 器 ; Eum, E5 
onResume () 方法 @， 通 知 主导 器 当前 视图 已 经 准备 完毕 ， 可 以 把 控制 权 交 给 主导 器 了 。 


主导 器 的 代码 比较 简单 ， 其 didFinishLoading () 方法 的 源码 如 下 所 示 : 


public void didFinishLoading() ( 


ISplashView view - getView(); < 一 一 获取 视图 , 本 例 中 即 是 设 


if (mConnectionStatus.isOnline()) ( Q 5i S fe Activity 
view.moveToMainView(); 


) else | < 判断 程序 是 否 继续 
view.hideProgress(); e» 执行 的 代码 逻辑 
view.showNoInetErrorMsg(); 

} 


通过 主导 器 的 getter 方 法 Q@ 获 取 |SplashView 接 口 的 实现 类 的 引用 。 通 过 模型 中 |ConnectionStatus 接 口 的 实现 类 验证 网 络 
是 否 连 好 @。 根 据 网 络 连接 情况 ， 会 对 视图 做 出 不 同 的 操作 。 可 以 看 出 ， 主 导 器 通过 接口 访问 视图 ， 主 导 器 并 不 知道 该 接口 是 由 
Activity 实 现 的 。 这 样 ， 在 单元 测试 中 就 更 容易 模拟 内 (mock) 视图 。 





[1] Model-View-Controllerz& X, TE 





[2] Model-View-Presenterz& X; 译 者 注 
[B] 在 MVC 模 式 中 ， 视 图 可 以 包含 访问 模型 的 逻辑 。 在 MVP 模 式 中 ， 视 图 与 模型 是 隔离 的 ， 所 有 与 视图 和 模型 的 交互 操作 都 在 主 
导 器 中 完成 ， 因 此 主导 器 在 整个 MVP 模 式 中 处 于 “主导 ”地 位 ， 这 也 是 我 将 Presenter 翻 译 为 主导 器 的 原因 。 


[4] 详情 请 参考 mock 测 试 相关 内 容 。 





译 者 注 





译 者 注 


20.1 概要 


MVP 模 式 可 以 使 代码 更 易 组 织 且 更 易 测试 。 在 示例 代码 中 ， 读 者 可 以 看 到 一 个 测试 文件 夹 ， 在 测试 代码 中 需要 初始 化 主导 
器 并 模拟 (mock) 接口 。 在 主导 器 中 并 未 使 用 任何 Android 平 台 相 关 的 代码 ， 因 此 不 需要 在 Android 设 备 上 运行 测试 用 例 ， 只 
需要 在 JVM 上 运行 即 可 。 此 外 ， 在 本 例 中 我 们 使 用 Mockito[l 模 拟 接口 。 


在 Android 平 台 上 开 友 应 用 程序 ， 读 者 会 友 现 Activity 中 会 存在 大 量 代码 。 遗 憾 的 是 ， 测 试 Activity 是 很 痛 藻 的 。 使 用 MVP 模 
式 不 仅 可 以 简化 创建 测试 用 例 的 过 程 ， 还 可 以 更 容易 地 实施 TDD (test-driven development， 测 试 驱动 开 友 ) 。 





[1] Mockito 相 关内 容 参 见 http://code.google.com/p/mockito/。 译 者 注 


20.2 ”外 部 链接 


http://en.wikipedia.org/wiki/Model View Presenter 
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当 某 些 事 件 或 者 操作 发 生 时 ，Android 可 以 通过 多 种 消息 通知 应 用 程序 。 例 如 ， 开 发 者 想 知 道 设备 当前 是 否 联 网 ， 束 需要 通 
过 BroadcastReceiver 监 听 一 个 动作 (Action) 为 android.net.conn.CONNECTIVITY CHANGE 的 Intent。 


虽然 可 以 通过 BroadcastReceiver 监 听 操 作 系 统 友 出 的 不 同 通知 ， 但 是 开 上 友 者 不 能 企 BroadcastReceiver 中 访问 Activity。 


假设 需要 根据 网 络 连 接 状态 更 新 UI， 应 该 怎么 做 ? 如 果 想 在 Activity 中 获取 BroadcastReceiver 的 信息 ， 应 该 怎么 做 ? 在 这 
个 Hack 里 ， 我 会 向 读者 展示 如 何 将 BroadcastReceiver 作 为 Activity 的 内 部 类 使 用 以 获取 广播 对 应 的 Intent。 


将 BroadcastReceiver 做 为 Activity 的 内 部 类 使 用 ， 可 以 实现 两 个 重要 的 功能 
- 在 BroadcastReceivet 内 部 访问 Activity 的 方法 ; 
: 根据 Activity 的 状态 开启 或 者 关闭 BroadcastReceiver。 


为 了 演示 本 Hack， 我 们 会 创建 一 个 Service， 该 Service 激 活 后 会 等 待 5 秒 ， 然 后 友 送 一 个 广播 。 在 示例 代码 中 ， 该 广播 携 市 
一 条 日 期 信息 。Service 的 具体 实现 并 不 重要 ， 只 需要 知道 它 广播 了 一 个 Intent， 该 Intent 的 动作 为 
com.manning.androidhacks.hack021.SERVICE MSG, 该 Intent 的 附加 信息 (extra) 为 日 期 信息 。 


我 们 需要 根据 Service 发 送 的 日 期 信息 来 更 新 U1， 因此 只 需要 在 Activity 界 面 显示 的 时 候 监 听 这 则 信息 。 实 现 上 述 功 能 的 源码 
如 下 所 示 : 


public class MainActivity extends Activity { 
private ProgressDialog mProgressDialog; 
private TextView mTextView; 


private BroadcastReceiver mReceiver; 
private IntentFilter mIntentFilter; 


QaOverride 

public void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


D 创建 BroadcastReceiver 


E 
mReceiver - new MyServiceReceiver(); 


mlIntentFilter - new IntentFilter(MyService.ACTION); «| i l 
创建 IntentFilter， 4E 


startService(new Intent(this, MyService.class)); Y 该 BroadcastReceiver 
| | "qp v LZ. 
6) 对 象 可 以 接收 哪 种 类 


mm Intent 


QOverride 
protected void onResume() { 
super.onResume(); 


registerReceiver(mReceiver, mIntentFilter); < 在 onResume() 
} M. ai cun 
方法 中 注册 播 
QOverride Ws py ss 
public void onPause() { 
super.onPause(); 
unregisterReceiver (mReceiver); < 在 onPause() Ù 
法 中 取消 注册 
private void update(String msg) { 播 监听 器 
/* Do something with the msg */ 
} 
class MyServiceReceiver extends BroadcastReceiver { 调用 Activit 
H ctivity 
QGOverride #J update() 
public void onReceive (Context context, Intent intent) ( TS 
方法 


update(intent.getExtras().getString(MyService.MSG, KEY)); 
} 


下 先 创建 BroadcastReceiver 对 象 @@， 然 后 创建 IntentFilter@OD， 通 过 该 对 象 定义 BroadcastReceiver 对 象 可 以 监听 哪 种 类 型 
的 Intent。 因 为 只 在 Activity 内 部 使 用 BroadcastReceiver 对 象 ， 因 此 需要 在 onResume () 方法 @ 中 注册 ， 在 onPause () 方法 
@ 中 取消 注册 。 当 BroadcastReceiver 执 行 时 ,会 从 Intent 的 extra 成 员 中 获取 日 期 信息 ， 并 以 此 为 参数 调用 Activity 的 
update () 万 法 。 


就 这 么 简单 ， 我 们 创建 了 一 个 BroadcastReceiver， 只 在 Activity 显 示 的 时 候 才 去 更 新 U1。 


21.1 概要 


整个 Android 生 态 系统 都 使 用 Intent 进 行 交 互 ， 开 发 者 免不了 会 用 到 Intent。 在 Activity 中 以 内 部 类 的 形式 使 用 Broadcast- 
Receiver， 可 以 将 Intent 携 带 的 信息 反馈 到 界面 上 。 此 外 ， 在 适当 的 时 候 取 消 注册 BroadcastReceiver 是 避免 不 必要 的 Ul 更 新 操 
作 的 好 方法 。 


21.2 ”外 部 链接 


http:;//developer.android.com/reference/android/content/Intent.html 


http:;//developer.android.com/reference/android/content/BroadcastReceiver.html 


Hack22 ”使 用 Android 库 项 目 时 适用 的 架构 模式 


Android v1.6- 


在 Android 库 项 目 (Library Project) 发 布 之 前 ， 在 不 同 Android 项 目 间 共 享 代 码 是 很 困难 甚至 是 不 可 能 的 。 通 常 可 以 使 用 
JAR 包 共享 java 代码 ， 但 是 却 无 法 共享 那些 需要 引用 资源 文件 的 代码 。 共 享 Activity 或 者 自 定义 视图 是 不 可 能 的 ， 因 为 开 友 者 无 
法 把 资源 文件 添加 到 JAR 包 中 ， 供 其 他 应 用 程序 使 用 。 为 了 解决 共享 代码 的 问题 ，Android 库 项 目 应 运 而 生 了 。 在 这 个 Hack 里 ， 
我 会 展示 库 项 目的 使 用 方法 。 


我 会 创建 一 个 具有 登录 界面 的 小 应 用 程序 作为 本 Hack 的 示例 程序 ， 该 程序 划分 为 以 下 的 三 层 结构 : 
` 后 台 人 逻辑 和 模型 (JAR 文 件 ) 
Android 库 项 目 


- Android 应 用 程序 


22.1 ”后台 远 辑 和 模型 
本 层 是 一 个 简单 的 JAR 文 件 ， 该 文件 可 以 包含 业务 逻辑 ， 并 且 不 使 用 Android 平 台 特 有 的 代码 。 我 们 把 请 求 服务 器 的 代码 、 
业务 对 象 以 及 业务 逻辑 放置 在 该 层 。 在 示例 程序 中 ， 有 一 个 可 以 编译 成 JAR 文 件 的 项 目 ， 用 于 实现 具体 的 登录 功能 


如 图 22-1 所 示 ，Login 类 并 不 依赖 于 Android 平 台 。 访 项 目的 输出 文件 是 一 个 JAR 包 ， 可 以 将 该 JAR 包 引入 到 Android 应 用 程 
序 中 。 在 Java 项 目 中 实现 业务 逻辑 意味 着 可 以 直接 用 夕 nit 测 试 所 有 代码 ， 这 样 便 避 免 了 构建 Android 测 试 环境 所 市 来 的 麻烦 。 
此 外 ， 代 码 分 层 可 以 使 不 同 拉 术 背景 的 开 友 者 专注 于 各 上 自 所 擅长 的 层 。 


Y 1:22 hack022-Login 
v (8 src 
Y 83 com.manning.androidhacks.hack022.login 
> [J] Login.java 
v (zB test 


Y 83 com.manning.androidhacks.hack022.login 
> [J] LoginTest.java 
P BÀJRE System Library [J2SE- 1.5] 
b mà Junit 4 





图 22-1 在 Eclipse 中 加 载 Lopgin 项 目 


22.2 ” 库 项 目 


刚才 已 经 说 过 ，Android 库 项 目 类 似 于 JAR 包 ， 但 是 却 可 以 使 用 Android 资 源 文 件 。 将 Android 库 项 目 设 置 为 其 个 应 用 程序 
的 依赖 项 目 时 ， 该 应 用 程序 就 拥有 了 第 二 个 R 类 ， 该 R 类 中 包含 了 库 项 目的 资源 ID 信息 ， 因 此 我 们 便 可 以 在 代码 中 使 用 库 项 目 所 
属 的 资源 文件 。 本 层 包 含 的 Android 平 台 特 定 的 Activity、 自 定义 视图 或 者 service 等 都 是 可 以 复 用 的 。 


在 图 22-2 中 ， 可 以 看 到 Android 库 项 目 androidlib。 这 个 项 目 是 依赖 于 Android 平 台 的 ， 这 意味 着 开 友 者 可 以 在 该 项 目 中 使 
用 任何 Android 提 供 的 类 或 资源 。 每 个 Android 库 项 目 都 有 自己 的 R 类 。 


Y GS. hack022-androidlib 
v (28 src 
Y HH com.manning.androidhacks.hack022.androidlib 

> [T] LoginActivity.java 

» 日 # gen [Generated Java Files] 

P màAndroid 1.6 

P EA Android Dependencies 

Ea assets 

» ci bin 

v ia, res 

b (S drawable-hdpi 

> © drawable-ldpi 

P (— drawable-mdpi 

Y (layout 
iX] login.xml 

Y (z» values 
IX] login, attr.«ml 
X) login, strings.xml 
login styles green.xml 
X! login, styles. red.xml 
login, styles.xml 
login themes green.xml 
login themes red.xml 

ia AndroidManifest.xml 

proguard.cfg 

project.properties 

























图 22-2 ”在 Eclipse 中 加 载 Andtroid 库 项 目 


注意 ， 库 项 目 可 以 使 用 上 一 小 节 提 到 的 JAR 包 作为 依赖 库 。 在 本 例 中 ， 我 们 便 将 JAR 包 设置 为 库 项 目的 依赖 库 。 通 过 这 种 方 
式 ， 开 发 者 便 拥有 了 一 个 可 以 用 于 任何 Android 项 目 ， 并 且 模 块 化 、 易 维护 的 库 。 


223 Android 应 用 程序 


最 终 的 Android 应 用 程序 通过 后 台 逻 辑 和 模型 层 的 JAR 包 处 理 与 平台 无 关 的 业务 逻辑 ， 通 过 Android 库 项 目 处 理 与 Android 
平台 相关 的 逻辑 。 读 者 可 以 在 图 22-3 所 示 的 项 目 中 看 到 Android 库 项 目 是 如 何 包含 到 应 用 程序 项 目 中 的 。 


了 加 hack022-SingleApp 
vB src 
Y {H com.manning.androidhacks.hack022.singleapp 

> [J] MainActivity.java 
P ES gen [Generated Java Files] 
P mà Android 1.6 

P mà Android Dependencies 

P c» bin 
Y 2» res 
b [= drawable-hdpi 
b (— drawable-lIdpi 
b C3 drawable-mdpi 
v (= layout 
iX) main.xml 

b (> values 
AndroidManifest.xml 

F) proguard.cfg 
project.properties 









































图 22-3 ”Andtoid 应 用 程序 文件 结构 


在 本 层 ， 我 们 既 可 以 使 用 JAR 包 中 的 代码 ， 也 可 以 使 用 Android 库 项 目 中 的 代码 。 此 时 开发 应 用 程序 ， 只 需要 处 理 代码 在 不 
同 层 的 分 布 问题 。 


22.4 概要 


本 Hack 对 使 用 库 项 目 时 适用 的 染 构 设计 做 了 简要 介绍 。 代 码 可 重用 且 易 维护 是 难以 实现 的 ， 但 是 现在 有 了 Android 库 项 
H, 一 切 镍 有 可 能 。 


22.5 ”外 部 链接 


http://developer.android.com/tools/projects/index.html#Library-Projects 


http://developer.android.com/tools/projects/projects-eclipse.html#SettingUpLibraryProject 


Hack 23 同步 适配器 模式 


Android v2.2 十 


几乎 所 有 Android 应 用 程序 都 会 使 用 互联 网 获取 信息 或 者 同步 数据 。 如 果 读 者 之 前 开发 过 应 用 程序 ， 可 能 会 有 很 多 方法 实现 
建立 网 络 连 接 并 在 加 载 数据 时 显示 一 个 进度 动画 的 功能 。 


23.1 一 般 方 法 


我 做 过 多 家 公司 的 承包 商 ， 在 这 些 经 历 中 ， 我 见 过 开 友 者 有 多 种 方式 处 理 数据 的 读 取 过 程 。 不 过 大 多 数 方 式 都 可 以 归结 为 下 
面 介绍 的 万 法 中 的 一 种 。 


23.1.1 使 用 AsyncTask 
AsyncTask 是 Android 用 于 处 理 线程 的 类 ， 通 过 该 类 ， 开 友 者 可 以 很 容易 地 把 代码 多 辑 从 一 个 线程 移 到 另外 一 个 线程 。 如 果 
读者 在 之 前 的 项 目 中 使 用 过 该 类 ， 下 面 的 故事 可 能 会 让 你 回忆 起 一 些 往事 中 的 小 插曲 。 


很 久 以 前 ， 你 开始 学 习 Android 开 太 。 你 知道 不 能 在 主线 程 中 运行 后 台 逻 辑 ， 因 此 你 遍 寻 网 络 查找 解决 方案 。 终 于 ， 你 从 一 
个 乐于 分 享 的 Android 开 上 友 者 那里 找到 了 一 篇 标题 为 “Painless Threading” 的 文章 。 文 章 结尾 处 〈 见 23.4 节 ) 有 下 面 这 段 话 : 


“对 于 单线 程 模型 ， 谨 记 两 个 原则 : 不 要 阻塞 UI 线程 ， 确 保 仅 在 UI 线程 中 访问 Android UI 控件 。” 
AsyncTask 可 以 很 容易 地 满足 上 述 两 个 原则 。 


因此 ， 你 学 会 了 如 何 使 用 AsyncTask 类 ， 然 后 开始 在 各 处 代码 中 使 用 访 类 。 不 管 UI 有 多 复 开 ， 也 不 管 解析 大 数据 耗 时 多 
久 ，AsyncTask 辟 是 弟 伴 你 左右 。 你 很 早 束 完 成 了 工作 任务 ， 然 后 对 大 公司 里 的 IJOs 开 友 者 嘲 失 道 : “Android 比 iOs 容 易 多 啦 ! 
我 可 以 早早 完成 工作 。 你 们 好 好 享受 晚上 加 班 的 乐趣 吧 ， 果 粉 们 ! " 


可 惜 ， 好 景 不 长 。 你 上 友 现 ， 当 AsyncTask 执 行 时 转动 设备 ， 应 用 程序 会 朋 溃 。 虽 然 这 个 问题 很 难 解 决 ， 但 是 你 总 算 想 了 个 从 
方法 暂时 应 付 过 去 了 。 后 来 ， 你 皮 现 应 用 程序 运行 一 段 时 间 后 还 是 会 朋 溃 ， 朋 省 的 原因 是 AsyncTask 又 持 的 并 及 任务 的 数量 
限 。 当 尝试 解决 第 二 个 缺陷 的 时 候 ， 你 发 现 很 多 继承 自 AsyncTask 的 内 部 类 充斥 着 Activity， 看 起 来 你 的 Activity 被 这 些 类 “ 污 


染 ” 了 。 人 很 长 时 间 ， 你 都 在 思考 哪里 出 了 问题 。 

如 果 读 者 打算 使 用 AsyncTask， 一 定 要 慎重 考虑 。 使 用 AsyncTask 的 唯一 理由 是 : 后 台 任 务 比较 简单 或 者 你 不 依赖 于 其 执行 
结果 。 接 下 来 ， 我 们 分 析 另 外 一 种 方法 。 
23.1.2 ”使 用 Service 


第 二 种 方法 是 使 用 Service 类 。 使 用 Service 可 以 避免 很 多 问题 ， 但 同时 也 引入 了 其 他 问题 。 下 面 的 关注 列表 会 经 常 提醒 我 使 
用 Service 是 否 合 适 : 


: 与 Activity 交 互 


决定 什么 时 候 以 及 如 何 启动 Service 


` 持久 化 数据 


这 个 方法 引入 的 问题 主要 是 由 系统 的 灵活 性 造成 的 。 例 如 ， 开 者 可 以 通过 不 同方 式 与 Activity 交 互 。Activity 是 人 否 应 该 绑 定 
到 Service? 是 否 需 要 使 用 Handler? 是 否 需 要 通过 Intent 交 互 ? 是 人 否 需 要 使 用 数据 库 共享 信息 ? 存在 太 多 不 确定 性 问题 ， 但 是 每 


个 问题 的 答案 都 是 “ 视 情况 而 定 ”。 


我 曾经 不 断 在 心中 思考 下 述 问 题 : Gmail 应 用 程序 是 如 何 运 作 的 ” 它 是 如 何 同步 数据 ， 并 且 能 离线 工作 ， 却 不 出 现 问 题 ” 答 
案 是 : Google 通 过 同步 适配器 (SyncAdapter) 实现 上 述 功 能 。 遗 憾 的 是 ， 尽 管 同步 适配器 是 Android 提 供 的 最 好 特性 之 一 ， 
但 是 却 缺乏 相应 的 文档 。 如 果 读 者 询问 其 他 Android 开 发 者 是 否 知 道 该 特性 ， 他 们 或 许 会 回答 “知道 ”， 但 是 他 们 可 能 从 未 使 用 


过 这 个 特性 。 


在 这 个 Hack 里 ,我 会 展示 如 何 使 用 同步 适配器 来 组 织 依 赖 于 网 络 的 应 用 程序 ， 以 使 开发 过 程 省 时 省 力 。 


23.2 我 的 万 法 


为 了 演示 这 种 方式 ， 我 会 创建 一 个 TODO 列 表 。 我 们 通过 服务 器 提供 一 个 网 页 前 端 界 面 ， 这 样 在 浏览 器 中 束 可 以 添加 TODO 
项 ， 界 面 效果 如 图 23-1 所 示 。 同 时 ， 服 务 器 提供 API 给 Android 设 备 使 用 ， 这 样 在 Android 上 可 以 实现 相同 的 功能 。Android 应 
用 程序 的 运行 效果 如 图 23-2 所 示 。 





图 23-1 服务 器 前 端 界 面 


alr — 
TEE ` "ELIEDM. 


Hackū023 





图 23-2 Android 应 用 程序 前 端 界面 


23.2.1 ”同步 适配器 是 什么 


同步 适配器 是 由 Android 平 台 启 动 的 Service。 在 这 个 Service 中 ， 可 以 放置 同步 代码 。 在 读者 还 没有 进入 迷糊 状态 之 前 ， 先 
去 看 一 下 Virgil Dobjanschi 在 Google MO 2010 大 会 上 发 表 的 题 为 “开发 基于 REST 的 Android 客 户 端 应 用 程序 ”的 报告 (0123.4 
节 ) 。 访 报告 无 疑 是 Google I/O 大 会 上 最 精彩 的 报告 之 一 ， 同 时 也 是 天 于 同步 适配器 的 最 好 人 资料 。 


同步 适配器 的 优点 主要 表现 在 以 下 几 个 方面 : 





. 后 台 自 动 同 步 数 据 (即便 并 未 打开 应 用 程序 ) 
处 理 服务 器 身份 验证 
- 处 理 网 络 重 连 


` 这 守 用 户 关 于 后 侣 同步 的 偏好 设置 。 


23.2.2 ”以 数据 库 代 蔡 服务 器 


暂时 先 不 考虑 同步 ， 我 们 仅仅 创建 一 个 只 在 本 地 运行 ， 并 且 在 数据 库 中 保存 信息 的 应 用 程序 。 为 此 ， 需 要 分 别 创建 3 个 类 : 
DatabaseHelper、TodoContentProvider 和 TodoDAO。 首 先 分 析 DatabaseHelper， 该 类 的 源码 如 下 所 示 : 


public class DatabaseHelper extends SQLiteOpenHelper { < 继承 有 自 SQL- 
public static final String DATABASE NAME = "todo.db"; o | 


! iteOpenHelper 
private static final int DATABASE VERSION - 1; 


public DatabaseHelper(Context context) ( 
super(context, DATABASE NAME, null, DATABASE VERSION); b dio 
) 指定 数 
| 据 库 名 
eUverrias | 和 版 本 
. public void onCreate(SQLiteDatabase db) ( 四 
db.execSQL("CREATE TABLE " Y 
+ TodoContentProvider.TODO TABLE NAME + " (" 
B + TodoContentProvider.COLUMN ID 
Ei EH " INTEGER PRIMARY KEY AUTOINCREMENT," 
DNE TodoContentProvider.COLUMN SERVER ID + " INTEGER," 
创建 数据 TodoContentProvider.COLUMN TITLE + " LONGTEXT," 
FEX TodoContentProvider.COLUMN STATUS FLAG + " INTEGER" 


i 


+ + + + + 


} 


QOverride 
public void onUpgrade(SQLiteDatabase db, int oldVersion, 


int newVersion) { atem 


db.execSQL("DROP TABLE IF EXISTS " + à 
i 式 (schema) 
TodoContentProvider.TODO TABLE. NAME); 
onCreate(db); 


DatabaseHelper 继 承 自 SQLiteOpenHelper@。 创 建 Database-Helper 时 需要 指定 数据 库 名 和 版 本 号 @， 该 类 需要 根据 上 
述 信息 判断 是 人 否 需要 创建 数据 库 表 G@) 以 及 是 人 否 需要 更 新 数据 库 模 式 @@。 现 在 先 别 着 急 看 数据 库 异 式 ， 稍 后 我 们 融会 理解 每 个 属性 
列 的 意义 。 


既然 DatabaseHelper 已 经 准备 就 绪 ， 我 们 可 以 创建 Content-Provider 了 。 提 醒 一 下 ， 如 果 读 者 从 未 使 用 过 
ContentProvider， 那 么 在 继续 阅读 下 文 之 有 前， 赶紧 在 网 上 搜索 下 相关 内 容 。 本 Hack 提 供 的 TodoContentProvider 类 并 没有 什 
么 特别 内 容 ， 接 下 来 我 们 分 析 其 query 方 法 是 如 何 实现 的 ， 源 码 如 下 所 示 : 


public 
public 


.getCanonicalName(); 


public 
public 
public 
public 


private 


private 


private 
private 


public 


"vnd. 


public 


"vnd. 


public 


+ AUTHORITY + 


public class TodoContentProvider extends ContentProvider { 


TODO. TABLE. NAME = "todos"; 
AUTHORITY - TodoContentProvider.class 


static final String 
static final String 


继承 上 月 Cont- 
entProvider 
COLUMN ID - " id"; 

COLUMN SERVER ID - "server id"; 

COLUMN TITLE s "title"; 

COLUMN STATUS FLAG - 


final String 
final String 
final String 
final String 


static 
static 
static 


static "Status flag"; 


final inb TODO = Il: 
final int TODO ID = 


static 


static 2; 


static 
static 


HashMap«String, String» projectionMap; 


final UriMatcher sUriMatcher; 


static final String CONTENT TYPE - 
android.cursor.dir/vnd.androidhacks.todo"; 
static final String CONTENT TYPE ID - 
android.cursor.item/vnd.androidhacks.todo"; 


static final Uri CONTENT URI = Uri.parse("content://" 
"/" + TODO TABLE. NAME) ; 


根据 内 容 


private DatabaseHelper dbHelper; 


static 


sUriMatcher - 


URI 判断 
( 执行 流程 


new UriMatcher (UriMatcher.NO MATCH); 


sUriMatcher.addURI(AUTHORITY, TODO TABLE NAME, TODO); 


sUriMatcher.addURI(AUTHORITY, TODO TABLE NAME + 


projectionMap - 
projectionMap.put(COLUMN ID, COLUMN ID); 
projectionMap.put (COLUMN SERVER, ID, COLUMN. SERVER, ID) ; 


"/$", TODO ID); 


改变 列 
映射 


new HashMap«String, String»^»(); 


projectionMap.put(COLUMN TITLE, COLUMN TITLE); 
projectionMap.put(COLUMN STATUS FLAG, COLUMN STATUS FLAG); 


) 


Q 2! £& Content- 


QGOverride 
public boolean onCreate() ( a Provider 
dbHelper - new DatabaseHelper(getContext()); 


return true; 


aOverride 
public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 


SOLiteQueryBuilder qb - new SQLiteQueryBuilder(); 


switch (sUriMatcher.match(uri)) ( i ; 
FK - JL 
case TODO: H& 据 URIPE 配 
: ios / di Y fh. 
qb.setTables(TODO TABLE NAME); switch ^r 3c, Jf 
qb.setProjectionMap(projectionMap); 构建 查询 条 件 
break; 


case TODO ID: 
qb.setTables(TODO TABLE NAME); 
qb.setProjectionMap(projectionMap); 


qb.appendwWhere(COLUMN ID + "=" + uri.getPathSegments().get(1)); 
break; 
AH 置 URI default: 
内 zx ic throw new RuntimeException("Unknown URI"); 
io o ^ "" 
动 通知 ; @ 从 数据 
q ^ SOLiteDatabase db = dbHelper.getReadableDatabase(); h 
Cursor JÆ 3k H 
, N P | N 
uA Cursor c - qb.query(db, projection, selection, c i 
3k AI URI selectionArgs, null, null, sortOrder); Cursor 
内 容 的 变 n | | 
化 情况 cC.setNotificationUri(getContext().getContentResolver(), 
Ht uri); 


return C; 


TodoContentProvider 继 承 自 ContentProvider@。 在 TodoCon-tentProvider 中 ， 我 们 定义 了 一 个 UriMatcher， 用 于 根 
据 传 入 的 URI 匹 配 相 应 的 执行 流程 @@。 在 本 例 中 ，TodoContentProvider 使 用 的 ContentValues 与 数据 库 列 是 一 一 映射 的 。 如 果 
想 修 改 映射 名 ， 可 以 使 用 projectionMap@)。 在 创建 TodoContentProvider 时 @)， 我 们 创建 DatabaseHelper 对 象 ， 用 于 查询 数 
据 库 。 为 简单 起 见 ， 我 只 列 出 query () 方法 ，TodoContentProvider 中 其 他 方法 与 之 类 似 。 在 query () 方法 中 可 以 看 到 如 何 
根据 传 入 的 URI 匹 配 switch 分 文 以 及 如 何 正确 构建 查询 条 件 中 。 之 后 ， 我 们 通过 查询 条 件 从 数据 库 中 返回 一 个 Cursor， 最 终 会 把 
该 Cursor 返 回 给 调用 者 @。 注 意 最 后 一 行 代 码 @， 在 将 Cursor 返 回 给 调用 者 之 前 ， 我 们 注册 了 “URI 内 容 变动 通知 ”， 这 样 
Cursor 会 监控 URI 内 容 的 变化 ， 当 友 现 URI 内 容 友 生 改 变 时 ，Cursor 会 目 动 更 新 数据 。 


最 后 ，TodoDAO 负 责 通 过 ContentResolver 调 用 上 述 Todo-ContentProvider， 用 于 Java 对 象 和 和 数据库 对 象 的 相互 转化 ， 
其 源码 如 下 所 示 : 


public class TodoDAO { 


private static final TodoDAO instance - new TodoDAO(); 
private TodoDAO() () Qon 
public static TodoDAO getInstance() ( 二 


return instance; 


) 


业务 
public void addNewTodo(ContentResolver contentResolver, <1 方法 
Todo list, int flag) I 
ContentValues contentValue - getTodoContentValues(list, flag); 
contentResolver.insert (TodoContentProvider.CONTENT URI, 
contentValue); 1 k 
) 转化 成 Con- 
tentValues 


private ContentValues getTodoContentValues (Todo todo, 
int flag) ( 
ContentValues cv - new ContentValues(); 
cv.put(TodoContentProvider.COLUMN SERVER ID, todo.getId()); 
cv.put(TodoContentProvider.COLUMN TITLE, todo.getTitle()); 
Ccv.put(TodoContentProvider.COLUMN STATUS FLAG, flag); 


return CV; 


从 上 述 代 码 中 可 以 看 出 ，TodoDAO 通 过 单 例 模式 实现 人 四。 我 们 在 该 类 中 实现 了 类 似 addNewTodo () 这 样 的 业务 方法 
Q@， 该 方法 将 Java 对 象 转化 成 ContentValues 后 人 @@， 会 执行 一 次 数据 库 插 入 操作 。 


23.2.3 ” 填 元 数据 库 


本 节 学 习 如 何在 应 用 程序 中 操作 数据 库 。 我 们 会 用 到 下 面 两 个 Activity: 





MainActivity 一 一 用 于 显示 了 JODO 列表 


: AddNewActivity 





用 于 显示 一 个 表单 ， 用 于 添加 新 的 TODO 条 目 


这 两 个 Activity 功 能 相似 ， 都 是 通过 TodoDAO 更 新 数据 。MainActivity 的 源码 如 下 所 示 : 


public class MainActivity extends Activity { 


private ListView mListView; 
private TodoAdapter mAdapter; 


QGOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


mListView = (ListView) findViewById(R.id.main activity listview); 
mAdapter - new TodoAdapter(this); 创建 List- 
mListView.setAdapter (mAdapter); 
View p 
司 z} Add- 
public void addNew (View v) { NewA ctivity 


startActivity(new Intent(this, AddNewActivity.class)); 
} 


上 述 都 是 常规 代码 。 我 们 创建 一 个 ListView， 其 使 用 的 适配器 是 TodoAdapterQ@。 当 用 户 点 击 “Add New" i 
tH, AddNew-Activityix^r ActivitysiL aaz. 


TodoAdapter 中 有 不 少 有 趣 的 代码 ， 如 下 所 示 : 


public class TodoAdapter extends CursorAdapter ( 


private static final String[] PROJECTION IDS TITLE AND STATUS - 
new String[] ( 
TodoContentProvider.COLUMN ID, 
TodoContentProvider.COLUMN TITLE, 
TodoContentProvider.COLUMN STATUS FLAG ); 


public TodoAdapter(Activity activity) ( 
super(activity, getManagedCursor(activity), true); 
mActivity = activity; 


获取 一 个 


) 
Cursor 


private static Cursor getManagedCursor(Activity activity) ( 
return activity.managedQuery(TodoContentProvider.CONTENT URI, 


PROJECTION IDS TITLE AND STATUS, 


A 意 TodoCon- 
TodoContentProvider.COLUMN STATUS FLAG + " !- " e 


* StatusFlag.DELETE, null, tentProvider 的 
TodoContentProvider.DEFAULT SORT ORDER); URI FI 4j nmi H5 
j ( projection) 的 
QGOverride 用 法 
public void bindView(View view, Context context, Cursor c) { 
final ViewHolder holder = (ViewHolder) view.getTag(); 
holder.id.setText(c.getString(mInternalIdIndex)); 
holder.title.setText(c.getString(mTitleIndex)); 改变 文 
final int status = c.getInt(mInternalStatusIndex); WH E 
if (StatusFlag.CLEAN != status) { 
holder.title.setBackgroundColor (Color .RED); 


} else { 
holder.title.setBackgroundColor(Color.GREEN); 


) 


final Long id - Long.valueOf (holder.id.getText().toString()); 
holder.deleteButton.setOnClickListener(new OnClickListener() ( 


aOverride 
public void onClick(View v) ( 


TodoDAO.getInstance().deleteTodo( < 
mActivity.getContentResolver(), id); o enam 
| TODO 条 


构造 TodoAdapter 时 ， 通 过 Activity 的 managedQuery () 方法 获取 一 个 Cursor@。 留 意 代码 中 是 如 何 使 用 
TodoContentProvider 的 URI 和 列 映射 的 @。 最 后 ， 我 们 还 可 以 看 到 bindView () 方法 ， 通 过 该 方法 ， 可 以 根据 状态 标记 (D 
FX) 更 改 文本 背景 @。 此 外 ， 我 们 为 删除 按钮 设置 一 个 点 击 事件 监听 器 ， 在 该 监听 器 中 ， 通 过 TodoDAO 从 列表 中 删除 指定 的 
TODO 项 G@。 


怎么 没 看 到 notifyDataSetChanged () 方法 呢 ? 我 们 不 需要 这 个 方法 。 还 记得 我 们 在 TodoContentProvider 中 调用 过 
setNotifica-tionUri () 方法 吗 ?” 当 通过 ContentProvider 更 新 数据 库 的 时 候 ，TodoContentProvider 返 回 的 Cursor 也 会 被 更 


新 。 


到 目前 为 止 , 我 们 创建 了 一 个 可 以 向 数据 库 保存 数据 的 应 用 程序 。 现 在 ,我 们 需要 实现 身份 验证 以 及 与 服务 器 同步 数据 的 功 


dup 
GG 
o 


23.2.4 ”实现 登录 功能 


在 实现 同步 适配器 之 前 ， 先 来 看 看 如 何 处 理 服务 器 身份 验证 。 我 们 不 会 把 登录 信息 存储 于 数据 库 或 者 SharedPreferences 
中 ， 而 是 存储 于 Android 的 账户 (Account) 中 。 处 理 账 户 要 用 到 Android 提 供 的 AccountManager 类 ， 该 类 用 于 管理 账户 中 的 
用 户 赁 证。 基本 原理 是 : 一 旦 用 户 输入 用 户 凭证 ， 这 些 信息 会 被 保存 到 账户 中 。 具 备 USE_CREDENTIALS 权 限 的 应 用 程序 可 以 通 
过 AccountManager 查 询 到 账户 信 息 ， 进 而 获取 保存 在 账户 中 的 身份 验证 令 牌 或 者 其 他 可 以 用 于 服务 器 身份 验证 的 必要 信息 。 


在 编写 代码 前 ， 读 者 需要 理解 登录 功能 会 在 以 下 情况 下 用 到 : 
- 应 用 程序 启动 时 还 没有 账户 信息 被 创建 
-用户 在 “账户 & 同 步 ”菜单 中 点 击 “新 建 账户 ” 
同步 适配器 尝试 同步 数据 时 出 现 身 份 验证 错误 


本 证 先 分 析 前 面 两 种 情况 ， 等 同步 适配器 可 以 正常 工作 后 ， 青 分 析 最 后 一 种 情况 。 对 于 第 一 种 情况 ， 需 要 创建 
BootstrapActivity， 源 码 如 下 所 示 : 


public class BootstrapActivity extends Activity ( 
private static final int NEW ACCOUNT = 0; 
private static final int EXISTING. ACCOUNT - 1; 
private AccountManager mAccountManager; 


GOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 
setContentView(R.layout.bootstrap); 


Q 根据 类 型 获 


mAccountManager = AccountManager.get(this); 取 账 户 列 表 
Account[] accounts = mAccountManager < 
e» .getAccountsByType(AuthenticatorActivity.PARAM ACCOUNT TYPE); 
if (accounts.length == 0) { 
创建 新 final Intent i = new Intent(this, AuthenticatorActivity.class); 
账户 i.setFlags(Intent.FLAG ACTIVITY CLEAR, WHEN TASK RESET); 


sStartActivityForResult(i, NEW. ACCOUNT); 


€ ) else ( 


String password - mAccountManager.getPassword(accounts[0]); 
—D» if (password == null) ( 
3 sk HH final Intent i - new Intent(this, AuthenticatorActivity.class); 
户 输入 i.putExtra(AuthenticatorActivity.PARAM USER, accounts[0].name); 


o startActivityForResult (i, EXISTING. ACCOUNT); 
a } else ( 


StartActivity(new Intent (this, MainActivity.class)); <4 切换 到 Main- 
rinishti)s o u 
) Activity 


在 onCreate () 万 法 中 ， 根 据 类 型 获取 账 尸 询 表 @。 如 果 没 有 账 尸 ， 融 局 动 AuthenticatorActivity 创 建新 账 尸 @D; WRB 
经 有 账户 存在 ， 但 是 AccountManager 并 没有 查询 到 该 账户 对 应 的 密码 ， 就 需要 用 户 输入 密码 @， 当 密码 失效 时 会 发 生 上 述 情 
况 。 一 些 准 备 就 绪 后 ， 就 可 以 切换 到 MainActivity。@ 


第 二 种 情况 要 相对 复杂 些 ， 需 要 为 最 后 一 种 情况 预备 好 所 有 必需 条 件 。 要 在 设置 中 通过 “账户 尺 同步 ”菜单 创建 新 账户 ， 需 
要 添加 一 个 继承 自 AbstractAccountAuthenticator 的 类 。 


AbstractAccountAuthenticator 是 用 于 创建 账户 认证 器 (Account Authenticator) 的 基 类 。 要 提供 一 个 新 的 认证 器 ， 必 
须 继承 该 类 并 实现 其 抽象 方法 。 此 外 ， 还 需要 创建 一 个 Servicel |， 当 通过 Action 为 
— ERE 需要 在 该 Service 的 
onBind (android.content.Intent) 方法 中 返回 getlBinder () 方法 的 结 


我 们 创建 一 个 继承 自 AbstractAccountAuthenticator 的 Authen-ticator 类 ， 对 于 用 不 到 的 方法 ， 令 其 返回 null 就 可 以 了 。 
其 中 比较 重要 的 是 addAcount () 方法 和 getAuthToken () 方法 ， 其 源码 如 下 所 示 : 


public class Authenticator extends AbstractAccountAuthenticator { 
private final Context mContext; 


public Authenticator(Context context) ( 
super(context); 
mContext - context; 


} 


GOverride 

public Bundle addAccount í(AccountAuthenticatorResponse response, 
String accountType, String authTokenType, 
String[] requiredFeatures, Bundle options) 
throws NetworkErrorException { 


final Intent intent = new Intent (mContext, 
AuthenticatorActivity.class); 
intent.putExtra(AuthenticatorActivity.PARAM AUTHTOKEN TYPE, 


authTokenType) ; 
intent.putExtra(AccountManager.KEY ACCOUNT AUTHENTICATOR RESPONSE, 
response); 
final Bundle bundle = new Bundle(); 


bundle.putParcelable(AccountManager.KEY INTENT, intent); 


return bundle; 


QGOverride 

public Bundle getAuthToken(AccountAuthenticatorResponse response, 
Account account, String authTokenType, Bundle options) 
throws NetworkErrorException ( 


if (!authTokenType 
.equals(AuthenticatorActivity.PARAM AUTHTOKEN TYPE)) ( 


检查 请 求 
final Bundle result = new Bundle(); 的 令 牌 是 
result.putString(AccountManager.KEY ERROR MESSAGE, 二 相同 

个 H 


"invalid authTokenType"); 


return result; 


} 


final AccountManager am = AccountManager.get (mContext); 


final String password = am.getPassword (account); 
if (password != null) { < 一 
boolean verified = false; @ 获取 密码 
String loginResponse = null; 
try ( 
loginResponse = LoginServiceImpl.sendCredentials( 


account.name, password); 
verified = LoginServicelmpl.hasLoggediIn(loginResponse); 
) catch (AndroidHacksException e) ( 
verified - false; 


l 加 返回 结果 
if (verified) ( < 


final Bundle result = new Bundle(); 
result.putString(AccountManager.KEY ACCOUNT NAME, account.name); 


result.putString(AccountManager.KEY ACCOUNT TYPE, 
AuthenticatorActivity.PARAM ACCOUNT TYPE); 


return result; 


p dee diuini 
局 动 哪个 Activity 
final Intent intent = new Intent (mContext, + 让 用 户 登 录 


AuthenticatorActivity.class); 
intent.putExtra(AuthenticatorActivity.PARAM USER, account.name); 
intent.putExtra(AuthenticatorActivity.PARAM AUTHTOKEN TYPE, 


authTokenType) ; 
intent.putExtra(AccountManager.KEY ACCOUNT AUTHENTICATOR RESPONSE, 
response); 
final Bundle bundle - new Bundle(); 


bundle.putParcelable(AccountManager.KEY INTENT, intent); 
return bundle; 


addAccount () 方法 比较 明了 ， 访 方法 创建 了 一 个 Intent，AccountManager 会 使 用 该 Intent 创 建新 账户 。 现 在 分 析 


getAuthToken () 方法 。 当 需要 使 用 账户 中 存储 的 用 户 凭证 信息 登录 服务 器 时 ， 该 方法 就 会 被 调用 。 该 方法 首先 检查 请 求 的 令 


与 当前 处 理 的 令 牌 相同 四 ， 然 后 通过 AccountManager 获 取 密 码 ， 如 果 获 取 到 密码 @， 束 以 此 登录 服务 器 。 如 果 登 录 成 


功 @)， 就 返回 登录 结果 ; 如 果 登 录 不 成 功 ， 就 返回 一 个 Intent， 通 过 该 Intent 告 诉 调用 者 启动 哪个 Activity 让 用 户 重 新 登录 @。 


密码 改变 或 者 用 户 凭证 失效 时 会 出 现 上 述 情 ; 


下 一 个 要 创建 的 是 AuthenticatorActivity， 用 于 显示 登录 表单 ， 其 运行 效果 如 图 23-3 所 示 : 


[El m 
s | 
n : 
E || 
EI 


起 Hack023 





New accoun! 


Username 


Password 





OK 


图 23-3 ”AuthenticatorActivity 的 登录 表单 


其 源码 如 下 所 示 : 


public class AuthenticatorActivity extends 


AccountAuthenticatorActivity ( 
public 


static final String PARAM ACCOUNT TYPE - 


"com.manning.androidhacks.hack023"; 


public 
public 
public 

"confirmCredentials"; 


static final String PARAM AUTHTOKEN TYPE = 
static final String PARAM USER - 
static final String PARAM CONFIRMCREDENTIALS - 


"authtokenType" ; 
"user"; 


private AccountManager mAccountManager; 
private Thread mAuthThread; 
private String mAuthToken; 
private String mAuthTokenType; 
private Boolean mConfirmCredentials - false; 
private final Handler mHandler - new Handler(); 
protected boolean mRequestNewAccount - false; 
private String mUser; 
private void handleLogin(View view) ( 
if (mRequestNewAccount) ( 
mUsername - mUsernameEdit.getText().toString(); 
) 
mPassword - mPasswordEdit.getText().toString(); 
if (TextUtils.isEmpty(mUsername) || TextUtils.isEmpty(mPassword)) ( 


mMessage.setText(getMessage()); 


} 


showProgress(); 
mAuthThread - 
mPassword, mHandler, 


开局 线程 与 
服务 融通 信 


NetworkUtilities.attemptAuth (mUsername, 
AuthenticatorActivity.this); 


public void onAuthenticationResult(Boolean result) { «a [n Authenti- 


hideProgress(); @catorActivity 3& 
if (result) ( 回 验 证 结果 
if (!mConfirmCredentials) ( 
finishLogin(); 
) 
) else ( 
mMessage.setText("User and/or password are incorrect"); " : 
调 用 fini- 
) eu 
| | 方法 
private void finishLogin() ( 


final Account account - new Account(mUsername, PARAM i ' TYPE); 


if (mRequestNewAccount) ( 
mAccountManager.addAccountExplicitly(account, mPassword, null); 
) else ( 

mAccountManager.setPassword(account, mPassword); 


) 


final Intent intent - new Intent(); 
intent.putExtra(AccountManager.KEY ACCOUNT NAME, mUsernamoe); 


intent.putExtra(AccountManager.KEY ACCOUNT TYPE, 
PARAM ACCOUNT TYPE); 


if (mAuthTokenType !- null 
&& mAuthTokenType.equals (PARAM AUTHTOKEN TYPE)) { 
intent.putExtra(AccountManager.KEY AUTHTOKEN, mAuthToken); 
) 


setAccountAuthenticatorResult(intent.getExtras()); < 一 
setResult(RESULT OK, intent); 全 设置 结 
finish(); 


当 用 户 输入 登录 信息 并 点 击 “OK” 按钮 后 ， MN () 融会 被 调用 。 在 该 方法 中 局 动 一 个 线程 与 服务 器 通信 @@， 通 
信 结 果 会 通过 onAuthenticationResult () 方法 @ 返 回 给 AuthenticatorActivity。 如 果 服 务 验 证 成 功 ， 我 们 就 调用 
finishLogin () 方法 @， 否 则 就 向 有 用户 显示 一 条 错误 信息 提醒 用 户 重 新 登录 。 在 finishLogin () 方法 中 ， 如 果 设 置 了 请 求 创建 
新 账户 的 标记 (mRequestNewAccount) ， 就 通过 AccountManager 创 建 一 个 账户 ; 如 果 账 户 已 经 存在 ， 就 设置 一 个 新 密码 
@。 最 后 设置 请 求 结果 ®。 


最 后 一 步 是 在 AndroidManifest.xmI 中 注册 一 个 Service， 代 码 如 下 所 示 : 


该 服务 会 返 
«service android:name-".authenticator.AuthenticationService" —Á 
android:exported-"true"-» © 上 账户 
| | Wy uas 
«intent-filter» < 一 


«action android:name-"android.accounts.AccountAuthenticator" /> 
«/intent-filter» 


«meta-data android:name-"android.accounts.AccountAuthenticator" 
android:resource-"0xml/authenticator" /> 
«/service-» I 附加 信息 AN 


述 代 码 中 定义 了 Action 为 android.accounts.AccountAuthen-ticator 的 Intent 过 滤器 ， 告 诉 系 统 该 Service 会 返回 一 个 账 
户 验证 器 @@。 上 此外， 还 需要 通过 一 个 单独 的 XML 文件 @ 提 供 一 些 附加 信息 ， 本 例 中 ， 名 为 authenticator 的 XML 文件 内 容 如 下 所 


zT: 


«account-authenticator 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:accountType-"com.manning.androidhacks.hack023" 
android:icon-"QGdrawable/ic launcher" 
android:smalllcon-"Gdrawable/ic launcher" 
android:label-"Gstring/app name"/» 


上 述 文件 中 最 重要 的 信息 是 android: accountType。 访 属性 表示 当前 Service 返 回 的 账户 验证 器 只 用 于 验证 类 型 为 
com.manning.androidhacks.hack023 的 账户 。 其 他 属性 主要 用 于 定义 “账户 & 同 步 ” 菜 单项 的 外 观 。 


23.2.5 添加 同步 二 本 0 器 | 
最 后 一 步 融 是 添加 同步 适配器 。 这 了 这 么 多 ， 读 者 还 不 类 道 同 步 适 配器 是 什么 。 接 下 来 通过 分 析 同 步 适 配器 为 上 文 所 写 的 大 
量 代码 画 上 一 个 完美 的 句号 。 


同步 适配器 是 一 个 由 Android 平 台 处 理 的 Service， 该 Service 通 过 账户 实现 与 服务 器 的 身份 验证 ， 使 用 ContentProvider 同 
步 数据 。 实 现 同步 适配器 后 ， 应 用 程序 可 以 目 动 与 服务 器 同步 数据 。 操 作 系 统 将 当前 同步 适配器 连同 其 他 同步 适配器 一 起 注册 到 
设备 中 。 同 步 适 配器 每 次 只 运行 一 个 ， 这 样 可 以 避免 网 络 阻塞 。 到 目前 为 止 ， 这 是 不 是 你 用 过 的 最 好 特性 ” 接 下 来 分 析 如 何 实现 
一 个 同步 适配器 。 


首先 需要 在 AndroidManifest.xm| 文 件 中 声明 该 同步 适配器 : 


«service android:name-".service.TodoSyncService" 
android:exported-"true"» e Æ X. android. 
«intent-filter» content. 
| «action android:name-"android.content.SyncAdapter" /> <- 二 SyncAdapter 
«/intent-filter» 
«meta-data android:name-"android.content.SyncAdapter" 
android:resource-"Qxml/todo, sync adapter" /> < © 附加 XML 资源 


-/service» 


与 AuthenticationService 类 似 ， 我 们 定义 名 为 android.content.SyncAdapter 的 Action， 表 明 该 TodoSyncService 是 一 个 
同步 适配器 @@。 上 此外， 还 需要 定义 一 个 附加 XML 文件 @， 该 文件 内 容 如 下 所 示 : 


«sync-adapter xmlns:android-"http://schemas.android.com/apk/res/android" 
android:contentAuthority- 
"com.manning.androidhacks.hack023.provider.TodoContentProvider" 
android:accountType- 

"com.manning.androidhacks.hack023" /» 


上 述 XML 文 件 表示 TodoSyncService 会 用 到 TodoContent-Provider 的 authority， 并 且 需 要 使 用 的 账户 类 型 是 


com.manning.androidhacks.hack023, 


下 一 步 需要 创建 继承 自 AbstractThreadedSyncAdapter 的 类 ， 源 码 如 下 所 示 : 


public class TodoSyncAdapter extends AbstractThreadedSyncAdapter { 
private final ContentResolver mContentResolver; 
private AccountManager mAccountManager; 


private final static TodoDAO mTodoDAO = TodoDAO.getInstance(); 


aOverride 


public void onPerformSync(Account account, Bundle extras 
String authority, ContentProviderClient provider, 


从 服 务 pg SyncResult syncResult) { — 
获取 所 有 | try 器 端 已 经 删除 
TODO 条 目 一 List«Todo» data = fetchData(); TODO 4H 
syncRemoteDeleted(data); 1 
-" > SsyncFromServerToLocalStorage(data); 
Ji] 用 syncFrom- syncDirtyToServer( @ 从 数据 库 中 查询 
ServerToL ocal- mTodoDAO.getDirtyList (mContentResolver)); 所 有 状态 不 一 致 


Storage | EUN A X 
) catch (Exception e) ( q 
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handleException(e, syncResult); 


i 做 添加 、 更 新 、 
删除 等 同步 操作 


private void handleException(Exception e, 
SyncResult syncResult) { 


Mz. 
o 处 
if (e instanceof AuthenticatorException) 理 方式 
syncResult.stats.numParseExceptions++; 


} else if (e instanceof IOException) { 
syncResult.stats.numlIoExceptions--; 


onPerformSync () 方法 是 在 后 台 绪 程 中 执行 的 ， 与 服务 器 同步 的 逻辑 残 放 企 访 万 法 中 。 在 下 面 的 内 容 中 ， 我 会 介绍 一 种 
我 之 前 用 过 的 同步 方式 ， 读 者 不 必 局 限于 这 种 方式 。 


不 记得 TODO 数 据 库 表 中 每 行 数据 的 样子 吗 ? TODO 数 据 库 表 定义 了 如 下 的 属性 列 : 








* serverid 


同步 后 ， 每 行 数 据 都 会 从 服务 器 获取 一 个 远程 ID 


.status_flae 一 一 数据 状态 ， 可 以 是 CLEAN、MOD、ADD 和 DELETE 





- title TODO 条 目的 文本 内 容 


同步 开始 后 ， 首 先 从 服务 器 端 获 取 所 有 TODO 条 目 。 注 意 ， 如 果 TODO 条 目 太 多 ,我 们 需要 使 用 分 页 显示 。 第 二 步 是 从 本 
地 数据 库 移 除 服 务 器 端 已 经 不 仔 在 的 TODO 条 目 ， 要 实现 这 一 步 ， 首 先 需 要 从 本 地 数据 库 中 获取 所 有 状态 标记 为 CLEAN 的 条 
目 ， 然 后 判断 服务 器 端 是 否 存 在 该 条 目 ， 如 果 丰 存在， 束 从 本 地 数据 库 删 除 访 条目。 之 后 需要 调用 
syncFromServerToLocalStorage () 方法 @， 在 该 方法 中 ， 首 先 遍 历 服务 器 端的 TODO 条 目 ， 并 通过 server id 判断 该 条 目 是 否 
仓 在 于 本 地 数据 库 ， 如 果 和 存在 ， 束 以 服务 器 疹 的 信息 更 新 本 地 条 目 ， 如 果 不 仔 企 ， 融 在 本 地 数据 库 新 建 一 个 条 目 。 最 后 一 


步 


syncDirtyToServer () 方法 @， 从 本 地 数据 库 中 获取 所 有 状态 标记 为 dirty (dgECLEAN) 的 条 目 ， 然 后 根据 状态 标记 ， 或 者 在 服 
务 器 疡 添加 条 目 ， 或 者 在 服务 器 冰 更 新 或 删除 条 目 。 


留意 异常 处 理 方式 ©®。 根 据 异 常 类 型 的 不 同 修改 syncResult 对 象 。 这 样 做 的 目的 是 帮助 同步 管理 器 选择 在 合适 的 时 机 重新 调 
用 同步 适配器 。 


最 后 一 个 步骤 是 在 TodoSyncService 中 封装 同步 适配器 ， 代 码 如 下 所 示 : 


public class TodoSyncService extends Service { 
private static final Object sSyncAdapterLock = new Object(); 
private static TodoSyncAdapter sSyncAdapter - null; 


QOverride 
public void onCreate() { 
synchronized (sSyncAdapterLock) ( 
if (sSyncAdapter == null) { 
sSyncAdapter = new TodoSyncAdapter ( 
getApplicationContext(), true); 


) 


QOverride 
public IBinder onBind(Intent intent) ( 
return sSyncAdapter.getSyncAdapterBinder(); 





译 者 注 


[1] 该 Service 即 AuthenticationService。 


23.3 ”概要 


或 许 读者 会 认为 使 用 同步 适配器 很 麻烦 ， 但 是 应 该 看 到 ， 当 整个 模型 和 ContentProvider 创 建 后 ， 一 切 都 变 得 简单 了 。 用 户 
可 以 在 离线 和 在 线 的 状态 使 用 应 用 程序 ， 他 们 不 会 注意 到 差别 。 注 意 ， 我 并 没有 分 析 服 务 器 端 代码 ， 对 于 本 例 ， 我 使 用 web.py 
框架 编写 了 一 个 小 的 Python 服 务 器 。 如 果 读 者 打算 试用 同步 适配器 ， 我 建议 使 用 类 似 于 StackMob 的 平台 ， 这 样 可 以 避免 在 编 
写 后 端 程序 上 浪费 过 多 时 间 。 


23.4 ”外 部 链接 


http://developer.android.com/reference/android/os/AsyncTask.html 
http://www.youtube.com/watch?feature=player embedded&v=xHXn3Kg2IQE 


http://android-developers.blogspot.com.ar/2009/05/painless-threading.html 


http://logc.at/2011/11/08/the-hidden-pitfalls-of-asynctask/ 
http:;//developer.android.com/reference/android/content/AbstractThreadedSyncAdapter.html 
http:;//www.youtube.com/watch?vzxHXn3Kg2lQE&featurez yout u.be 
http://developer.android.com/guide/topics/providers/content-provider-creating.html 
http:;//naked-code.blogspot.com/2011/05/revenge-of-syncadapter-synchronizing.html 
http:;//developer.android.com/reference/android/content/AbstractThreadedSyncAdapter.html 


https:;//www.stackmob.com/ 


第 6 章 ”活用 列表 和 适配器 


列表 (List) 和 适配器 (Adapter) 是 Android 开 妈 过 程 中 需要 掌握 的 两 个 主要 概念 。 本 章 ， 我 们 学 习 几 个 适用 于 询 表 和 适 
配器 的 技巧 和 窗 门 。 


Hack 24 ”处 理 空 列表 
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在 移动 平台 上 ， 通 弟 使 用 列表 向 用 户 展示 数据 。 使 用 列表 时 ， 开 妈 者 需要 考虑 两 种 情况 : 列表 中 列表 项 是 满 的 以 及 空 状态 。 
对 于 列表 ， 可 以 使 用 ListView 实 现 ， 但 是 如 何 处 理 列 表 为 空 的 状态 呢 ” 玫 运 的 是 ， 有 一 个 简单 方法 可 以 解决 上 述 问题 。 接 下 来 分 
析 如 何 解决 这 个 问题 。 


ListView 以 及 其 他 继承 自 AdapterView 的 类 可 以 通过 setEmptyView (View) 方法 很 容易 地 处 理 空 状态 。 当 需要 绘制 
AdapterView 时 ， 如 果 适 配器 为 null 或 者 适配器 的 isEmpty () 方法 返回 true， 此 时 会 显示 setEmptyView (View) 方法 所 设置 
的 视图 。 


举例 说 明 。 假 设 需要 创建 一 个 应 用 程序 处 理 TODO 列 表 。 主 界面 是 一 个 显示 所 有 TODO 项 的 ListView， 但 是 当 第 一 次 局 动 该 
应 用 程序 的 时 候 ， 列 表 是 空 的 。 对 于 这 种 空 状态 ， 我 们 在 界面 上 绘制 一 张 图 片 。XML 布 局 文件 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?-» 

«FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill Parent"> 


«ListView android:id-"G-id/list view" 
android:layout width-"fill parent" 
android:layout height-"fill parent"/» 


«ImageView android:id-"G«id/empty view" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:src-"QGdrawable/empty view"/» 


«/FrameLayout-» 


最 后 需要 实现 的 就 是 onCreate () 方法 ， 在 该 方法 中 ， 我 们 获取 ListView 并 且 将 ImageView 设 置 为 空 状 态 时 显示 的 视图 。 
代码 如 下 所 示 : 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


ListView mListView = (ListView) findViewById(R.id.list view); 
mListView.setEmptyView(findViewById(R.id.empty view)); 


我 们 并 没有 为 ListView 设 置 适 配器 ， 因 此 ， 运 行 代码 时 会 显示 ImageView。 


24.1 概要 


我 必须 得 承认 ， 我 知道 这 个 技巧 的 时 间 有 点 晚 。 在 此 之 前 ， 当 适配器 为 空 的 时 候 ， 我 一 直 采 用 隐藏 ListView 的 方式 。 当 使 用 
setEmptyView (View) 方法 时 ， 代 码 会 更 上 紧凑， 更 易 读 。 


读者 也 可 以 尝试 使 用 ViewStub 作 为 空 状态 时 显示 的 视图 。 该 方式 可 以 保证 在 不 需要 显示 该 视图 时 ， 不 必 填 充 (inflate) 该 
WE. 


24.2 ”外 部 链接 


http:;//developer.android.com/reference/android/widget/ListView.html 


Hack 25 通过 ViewHolder 人 优化 适配器 
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如 果 读 者 已 经 为 Android 平 台 编 写 过 应 用 程序 ， 就 可 能 使 用 过 Adapter 类 。 对 于 没有 使 用 过 该 类 的 读者 ， 可 以 看 看 Android 
开 友 文档 (125.275) 的 摘 述 ， 内 容 如 下 所 示 : 


“Adapter 对 象 是 AdapterView 和 底层 数据 间 的 桥梁 。Adaptet 用 于 访问 数据 项 ， 并 且 负 责 为 数据 项 生成 视图 。” 


在 这 个 Hack 里 ,我 会 对 Adapter 的 工作 原理 做 一 个 简短 介绍 ， 这 样 读者 束 可 以 快速 创建 一 个 Adapter 并 使 应 用 程序 尽 可 能 响 


AdapterView 是 一 个 抽象 类 ， 用 于 那些 需要 通过 Adapter 填 充 自身 的 视图 。 其 常见 子 类 是 ListView。 这 两 个 类 工作 原理 都 很 
简单 。 显 示 AdapterView 时 ， 会 调用 Adapter 的 getView () 方法 创建 并 添加 每 个 子 条 目的 视图 。Adapter 的 getView () 方法 
束 是 用 来 创建 这 些 视图 的 。Adapter 并 不 会 为 每 行 数据 都 创建 一 个 新 视图 ， 而 是 提供 了 回收 旧 视 图 的 方法 。 我 们 先 看 看 其 运行 机 
制 ， 然 后 再 分 析 如 何 充分 发 挥 回收 机 制 的 优势 。 


在 图 25-1 中 ， 读 者 可 以 看 到 实际 代码 中 的 一 个 回收 视图 的 案例 。A 中 显示 的 是 列表 第 一 次 加 载 时 的 界面 。B 中 显示 的 是 用 户 
同 下 滑动 界面 时 ，ltem1 消 失 的 情况 。 在 这 种 情况 下 ， 我 们 并 没有 释放 该 视图 的 内 存 ， 而 是 把 它 交 给 回收 器 (recycler) 。 当 
AdapterView 同 适配器 申请 下 一 个 视图 时 ，getView () 方法 天 会 被 调用 ， 我 们 便 会 通过 convertView 参 数 获取 一 个 被 回收 的 视 
图 。 这 样 ， 如 果 ltem1 和 ltem8 的 视图 相同 ， 残 可 以 修改 视图 文本 内 容 并 返回 。 返 回 的 视图 将 填充 C 中 下 万 的 空 日 区 域 。 


简 言 之 ， 当 getView () 方法 被 调用 时 ， 如 果 convertView 参 数 不 为 null， 融 使 用 convertView， 这 样 就 不 用 新 建 视 图 。 我 
们 需要 通过 convertView.findViewByld () 方法 获取 每 个 UI 控 件 的 引用 然后 使 用 与 当前 项 的 位 置 绑 定 的 数据 来 填充 视图 。 
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图 25-1 ie R EALE 


上 述 代码 已 经 可 以 正常 工作 了 ， 但 是 还 可 以 进一步 优化 下 。 我 们 使 用 ViewHolder 模 式 。ViewHolder 是 一 个 静态 类 ， 可 以 用 
于 保存 每 行 的 视图 以 避免 每 次 调用 getView () 时 都 会 调用 findViewByld () 。 


通过 例子 分 析 该 类 的 用 法 。 在 本 例 中 ， 我 们 创建 一 个 适配器 用 于 填充 一 个 视图 ， 该 视图 包含 一 个 ImageView 和 两 个 
TextView, 源码 如 下 所 示 : 


public View getView(int position, View convertView, ViewGroup parent) { 
final ViewHolder viewHolder; 


如 a convert- > if (convertView == null) { 
View Jj null, convertView = mInflater.inflate(R.layout.row_layout, parent, false); 
就 填充 视图 Q viewHolder - new ViewHolder(); 


viewHolder.imageView - (ImageView) 从 获取 控件 的 引用 
convertView.findViewById(R.id.image); <4 


viewHolder.text1 = 

(TextView) convertView.findViewById(R.id.text1); 
viewHolder.text2 = 

(TextView) convertView.findViewById(R.id.text2); 


把 View- me convertView.setTag(viewHolder); 如 Æ convert- 
Holder 存 合 ) else ( View 为 null, 
入 标记 中 viewHolder = (ViewHolder) convertView.getTag(); «— 回收 它 


} 


Model model = getItem(position); 


Ak * 6 viewHolder.imageView.setlImageResource(model.getIiImage()); < 填充 视 
model viewHolder.textl.setText (model.getText1()); ex 
对 象 viewHolder.text2.setText (model.getText2()); 图 


return convertView; 


) 


static class ViewHolder { 一 
public ImageView imageView; — QD viestiolder E 


public TextView text1; 
public TextView text2; 


如 果 convertView 为 null， 我 们 就 填充 一 个 视图 @。 创 建 视 图 后 ， 需 要 获取 视图 中 各 UI 控件 的 引用 ， 并 存 入 ViewHolder 中 
。 将 ViewHolder 存 入 标记 中 @。 如 果 convertView 不 为 null， 就 可 以 回收 利用 它 。 可 以 从 convertView 的 标记 中 获取 
ViewHolder@。 然 后 可 以 根据 视图 的 索引 位 置 得 到 模型 对 象 @， 之 后 使 用 模型 对 象 中 的 数据 信息 填充 该 视图 @@。ViewHolder 中 
以 公共 成 员 变 量 存 储 所 有 UI 控件 的 引用 @。 


25.1 概要 


几乎 所 有 Android 应 用 程序 多 少 都 会 用 到 列表 和 相册 (Gallery) 展示 数据 。 上 述 这 类 UI 控件 都 是 AdapterView 的 子 类 ， 理 
解 AdapterView 的 原理 以 及 如 何 与 适配器 交互 对 创建 高 性 能 的 应 用 程序 是 很 重要 的 。 使 用 ViewHolder 的 技 15 是 获取 高 性 能 列表 
的 好 方法 。 


25.2 ”外 部 链接 


http:;//developer.android.com/reference/android/widget/Adapter.html 


nttp://developer.android.co m/t rainin g/l Mp Ing-layol m i-scrolling.htn 
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假设 读者 需要 开 友 一 蒜 假 期 安排 的 应 用 程序 ， 该 程序 以 国 别 的 形式 向 用 尸 展 示 一 个 流行 度假 胜地 的 列表 。 为 了 显示 较 长 的 列 
表 ， 需 要 在 列表 中 添加 分 段 信 息 以 满足 东方 人 的 使 用 习惯 。 比 如 : 联系 人 应 用 程序 通常 根据 姓名 的 首 字 母 为 联系 人 分 组 ; 日 程 安 
排 应 用 程序 通常 根据 日 期 为 不 同 的 约会 分 组 。 读 者 可 以 使 用 类 似 于 iPhone 联 系 人 的 界面 设计 来 完成 上 述 需 求 。 在 该 界面 中 ， 有 
一 个 分 段 标 头 (section header) 随 列 表 滚 动 ， 当 前 分 段 标 头 一 直 显 示 在 屏幕 顶端 。 在 图 26-1 中 ， 突 出 显示 的 字母 天 是 分 段 标 
头 ， 其 下 方 的 列表 项 显示 首 字 母 与 分 段 标 头 相同 的 国家 。 在 Android 中 创建 图 中 所 示 界 面 似乎 有 点 困难 ， 因 为 ListView 并 没有 分 
段 或 者 分 段 标 头 的 概念 ， 它 仪 仪 包含 列 表 项 。 


Philippines 
Pitcairn Islands 
Poland 


Puerto Rico 





Reunion 
Romania 
Russia 


Rwanda 
S 


Sqo Tome and Principe 
Saint Helena 





图 26-1 分 段 后 的 国 别 列表 


Android 开 友 者 通 弟 需要 创建 两 种 类 型 的 列表 项 来 解决 上 述 问题 : 一 个 常规 列表 项 用 于 显示 数据 ， 一 个 特殊 列表 项 用 于 显示 
分 段 标 头 。 这 种 方式 需要 重 写 getViewTypeCount () 方法 ， 让 其 返回 2; 然后 修改 getView () 方法 ， 在 该 方法 中 创建 并 返回 
对 应 类 型 的 列表 项 。 实 践 中 ， 这 种 方式 会 导致 代码 逻辑 混乱 。 如 果 原 始 列 表 包含 20 个 列表 项 ， 使 用 上 述 方法 ， 适 配器 融 需 要 包 
含 21 到 40 个 列表 项 ， 列 表 项 的 数目 依赖 于 分 段 数 有 目 。 这 样 会 导致 复杂 的 代码 逻辑 :ListView 中 显示 的 是 第 15 个 可 视 列表 项 ， 但 
是 该 列表 项 在 原始 列表 中 可 能 是 第 9 个 列表 项 。 


更 简单 的 方法 是 在 列表 项 中 散 入 分 段 标 头 ， 然 后 根据 需要 显示 或 者 隐藏 分 段 标 头 。 这 样 便 大 幅 简 化 了 创建 询 表 以 及 选择 列表 
项 的 逻辑 。 读 者 可 以 创建 一 个 特殊 的 TextView， 让 其 堵 加 在 询 表 的 顶部 ， 当 列表 滩 动 到 一 个 新 的 分 段 时 ， 融 更 新 其 内 容 。 


在 创建 上 图 所 示 的 界面 之 前 ， 先 分 析 如 何 为 分 段 标 头 创建 XML 布局 文件 。 我 们 以 上 图 中 第 3 个 分 段 标 头 R 为 例 ， 其 XML 布局 
文件 见 下 文 。 我 们 在 单独 的 文件 中 为 分 段 标 头 创建 布局 ， 这 样 束 可 以 在 随 列 表 深 动 的 分 段 标 头 和 列表 顶部 的 固定 分 段 标 头 中 复 用 
这 个 布局 文件 。 源 码 如 下 所 示 : 


<?xml version-"1.0" encoding="utf-8"?> 

«TextView xmlns:android-"http://schemas.android.com/apk/res/android" 
android:id-"G-«id/header" 
style-"QGandroid:style/TextAppearance.Small" 

l . l H XE XU e f 
android:layout width-"fill parent" "um 
android:layout height-"wrap content" 
android:background-"4$0000ff" /> 


分 段 标 头 撒 定 了 目 定 义 背 景色 以 区 别 于 列表 中 的 普通 文本 。 现 在 ,我们 创建 一 个 包含 顶部 固定 分 段 标 头 的 XML 布 局 文 
件 ， 代 码 如 下 所 示 : 


«?xml version-"1.0" encoding="utf-8"?> 

«FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-2"fill. parent" 
android:layout height-"fill Parent"> 


«ListView 使 用 Android 
android:id-"QGandroid:id/list" 标准 列表 ID 
android:layout width-"fill parent" 
android:layout height-"fill parent"/» 


«include layout-"Glayout/header"/» 
«/FrameLayout» 


IROA T AndroidtagERSAZEID, Atea A EListActivityhj r žE. RES ESL E AEIR, IEEE 
可 以 与 列表 重 革 在 一 起 ， 以 显示 当前 所 在 分 段 。 


最 后 要 创建 列表 项 对 应 的 XML 布局 文件 。 该 布局 文件 既 包 合 数 据 项 也 包 合 分 段 标 头 ， 源 码 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"wrap content"-» 


QI v ig Bop 3E 
«include layout-"Glayout/header"/» <4 
<TextView 
android:id="@+id/label" 
style-"QGandroid:style/TextAppearance.Large" u 
android:layout width-"fill parent" 2 EA E RET 
android:layout height-"wrap content"/-» < 一 


«/LinearLayout» 


列表 项 中 的 分 段 标 头 @@ 会 在 新 的 分 段 开始 时 显示 ， 否 则 惑 会 被 隐藏 。1D 为 labe| 的 TextView@O 用 于 显示 列表 项 中 的 数据 项 。 
列表 项 、 分 段 标 头 与 数据 项 之 间 的 关系 如 图 26-2 所 示 。 


| Section He 
| Label 


List Item 


List |tem 





图 26-2 ”具备 文本 数据 项 和 分 段 标 头 的 列表 项 


26.2 ”创建 可 视 分 段 标 头 


接 下 来 ， 我 们 创建 Adapter 的 子 类 用 于 填充 列表 项 。 与 其 他 创建 分 段 列 表 的 方式 的 不 同 之 处 在 于 : 开发 者 只 需要 重 写 
getView () 方法 。 我 们 不 需要 返回 多 种 类 型 的 视图 ， 也 不 需要 在 分 段 列表 与 原始 列表 间 转 换 数 据 项 的 位 置 (position) 。 源 码 
如 下 所 示 : 


public class SectionAdapter extends ArrayAdapter<String> ( 
private Activity activity; 


public SectionAdapter(Activity activity, String[] objects) { 
super(activity, R.layout.list item, R.id.label, bjects); 


this.activity = activity; ^J H «E X TI 
) 图 指定 XML 
Q 布局 文件 
QOverride 


public View getView(int position, View view, ViewGroup parent) ( 


if (view == null) ( 
view = activity.getLayoutInflater().inflate( 
R.layout.list, item, parent, false); @ 检查 列 
) 表 项 起 
TextView header = (TextView) view.findViewByIG(R.id.header); COS 
String label = getItem(position); in F RE 
if (position -- < | 是否 发 
|| getItem(position - 1).charAt(0) !- label.charAt(0)) ( HÆ M ZS 


El /YN Et 
MEA ZJN ^] Ex "CHEN 
header.setVisibility(View.VISIBLE); 


Wo. Jf header.setText(label.substring(0, 1)); -— : 
更 改 分 段 @ es 隐藏 分 牙 
标 头 的 文 header.setVisibility (View.GONE); < ERA 

本 内 容 ! 


return super.getView(position, view, parent); 


如 果 我 们 为 自 定义 视图 提供 了 @XML 布 局 文件 ， 父 类 ArrayAdapter 就 可 以 完成 大 部 分 功能 。 创 建 列表 项 后 ， 需 要 检查 其 首 
母 是 否 发 生 改 变 D。 如 果 发 和 改变 ， 该 列表 项 就 是 分 段 中 的 第 一 项 ， 此 时 就 需要 修改 分 段 标 头 的 内 容 并 显示 该 分 段 标 头 @。 否 
则 ， 就 隐藏 该 分 段 标 头 @。 


然 可 以 正确 显示 列表 内 的 分 段 标 头 ， 接 下 来 ,我们 编写 一 个 辅助 方法 用 于 配置 屏幕 硕 部 悬浮 的 分 段 标 尖 。 源 码 如 下 所 示 : 


private TextView topHeader; O HT il^ Eb 3k 


private void setTopHeader(int pos) { 
final String text - Countries.COUNTRIES[pos].substring(0, 1); 


LtopHeader.setText(text); 2 € 更 新 文本 内 容 
} 


成 员 变 量 @ 用 于 访问 屏幕 项 部 的 分 段 标 头 。 当 开始 创建 或 者 浴 动 列表 时 ， 会 调用 这 个 辅助 方法 ， 通 过 该 万 法 找到 该 分 段 标 头 


对 应 的 字母 ， 并 以 此 更 新 其 文本 内 容 @)。 


26.3 ”最 后 一 步 


最 后 ， 我 们 在 Activity 的 onCreate () 方法 中 整合 所 有 内 容 。 配 置 列表 并 为 列表 设置 监听 器 ， 当 列表 深 动 时 ， 更 新 分 段 标 头 
的 内 容 。 产 码 如 下 所 示 : 


private int topVisiblePosition; 


public void onCreate (Bundle savedInstanceState) ( Lon NASA GA 
super.onCreate(savedInstanceState); Bt PLUR Dd 
setContentView(R.layout.list); -一 一 UT ss 
topHeader - (TextView) findViewById(R.id.top); 
setListAdapter(new SectionAdapter(this, Countries.COUNTRIES)); 
getListView().setOnScrollListener(new AbsListView.OnScrollListener() { 
QGOverride 
public void onScrollStateChanged(AbsListView view, 
int scrollState) ( 
// Empty. 
} 
QOverride 
public void onScroll(AbsListView view, int firstVisibleItem, 
int visibleltemCount, int totallItemCount) { 


if (firstVisibleltem !- topVisiblePosition) ( 
topVisiblePosition = firstVisibleItem; 9 调用 辅助 方法 
setTopHeader(firstVisibleItem); < 
o 初始 化 第 一 个 
列表 项 的 分 段 
setTopHeader (0); < 标 头 


} 


配置 好 UI 控件 后 @， 我 们 设置 一 个 滚动 监听 器 。 当 用 户 滚 动 列表 时 ， 检 查 位 置 是 否 变 化 。 如 果 位 置 改变 ,调用 辅助 方法 @ 
更 新 悬浮 的 分 段 标 头 。 当 列表 第 一 次 显示 时 ， 确 保 根据 第 一 个 列表 项 @ 初 始 化 分 段 标 头 。 


26.4 ”概要 


即便 ListView 并 非 原生 文 持 分 段 标 头 ， 但 是 ， 通 过 将 分 段 标 头 诸 入 到 列表 项 中 ， 并 在 适当 的 时 候 令 其 可 视 或 不 可 视 ， 这 样 ， 
开 上 友 者 仍然 可 以 很 容易 地 添加 分 段 标 头 。 尽 管 这 个 Hack 适 用 于 以 字母 排序 的 列表 ， 但 是 ， 万 法 本 身 可 以 应 用 于 任何 分 段 类 型 。 


26.5 ”外 部 捞 接 


http:;//developer.android.com/reference/android/widget/ListView.html 


http:;//developer.android.com/reference/android/widget/BaseAdapter.html 


Hack 27 ”使 用 Activity 和 Delegate 与 适配器 交互 
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很 多 Android UI 控件 使 用 Adapter 填 充 自身 。 每 一 个 显示 可 变数 量 列表 项 的 UI 控件 都 会 有 一 个 Apapter 来 填充 视图 。 这 意味 
着 ,开发 者 只 要 学 会 一 种 用 法 ， 就 可 以 很 容易 地 操作 更 多 UI 控件 。 这 个 方法 的 优势 在 于 可 以 把 所 有 视图 相关 的 逻辑 放 入 Adapter 
中 。 这 是 很 重要 的 ， 为 什么 呢 ? 因 为 开发 者 可 以 应 用 关注 点 分 离 (separation of concerns, SoC) 的 设计 原则 。 假 设 ， 读 者 需 
要 显示 一 个 电话 号 码 的 列表 ， 这 个 列表 的 每 行 有 两 个 不 同 的 可 点 击 控件 ， 一 个 控件 用 于 从 列表 中 删除 电话 号 码 ， 另 外 一 个 控件 用 


于 拨打 电话 。 读 者 会 把 这 些 控件 的 点 击 处 理 器 放 在 代码 的 什么 位 置 呢 ? 


在 这 个 Hack 里 ,我 们 分 析 如 何 通 过 委托 模式 (Delegation Pattern) 解决 上 述 问题 。 该 模式 会 帮助 开 友 者 把 所 有 业务 逻辑 
从 适配器 中 移 到 Activity 中 。 我 们 创建 一 个 简单 的 应 用 程序 ， 通 过 该 应 用 程序 可 以 同 列表 中 添加 电话 号 码 ， 列 表 中 每 一 行 都 有 一 


个 Remove 按 钮 ， 用 于 删除 电话 号 人 码 。 


我 们 的 解决 思路 很 简单 : 在 适配器 中 实现 “Remove” 按 钮 的 点 击 处 理 器 ， 但 是 ， 并 不 在 适配器 中 实现 删除 对 象 的 方法 。 我 


们 通过 一 个 委托 接口 调用 Activity 的 方法 删除 对 象 。 首 先 创建 适配器 的 代码 ， 如 下 所 示 : 
public class NumbersAdapter extends ArrayAdapter«Integer» ( 


public static interface NumbersAdapterDelegate { «T—— —34 
void removeltem(Integer value); 


) 


private LayoutInflater mInflator; 
private NumbersAdapterDelegate mDelegate; 


public NumbersAdapter(Context context, Listc«Integer» objects) ( 
super (context, 0, objects); 
mInflator = LayoutInflater.from(context); 


) 


aOverride 
public View getView(int position, View cv, ViewGroup parent) ( 


If fF null zcv J. d 


cv = mInflator.inflate(R.layout.number row, parent, false); 
} 
final Integer value = getItem(position); 
TextView tv - (TextView) cv.findViewById(R.id.numbers row text 


tv.setText(value.toString()); 


View button - cv.findViewById(R.id.numbers row button); 


button.setOnClickListener(new OnClickListener() ( 
QGOverride 
public void onClick(View v) ( 
if ( null != mDelegate ) { P 
mDelegate.removeltem(value); O nmi 


IF 


return cv; 


} 


public void setDelegate(NumbersAdapterDelegate delegate) { <4 为 适配器 
mDelegate = delegate; ; 
i 5 设置 委托 


i 6:5 


定义 委托 接口 @ 用 于 处 理 删 除 对 象 的 操作 @。 需 要 把 Activity 设 置 为 适配器 的 委托 ， 因 此 提供 一 个 设置 方法 @)。 


现在 适配器 已 经 准备 融 绪 ， 接 下 来 分 析 Activity 的 代码 : 


public class MainActivity extends Activity implements 


NumbersAdapterDelegate ( «j 实现 NumberAda- 
. M. 
private ListView mListView; gerne 
private ArrayList«Integer» mNumbers; HO 
private NumbersAdapter mAdapter; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
mListView = (ListView) findViewById(R.id.main listview); 
mNumbers = new ArrayListc«Integer»(); 
mAdapter - new NumbersAdapter(this, mNumbers); 
mListView.setAdapter (mAdapter); 
} 
GOverride 
protected void onResume() ( 
super.onResume(); 
mAdapter.setDelegate(this); Y. E 在 onResume() 
方法 中 注册 委托 
GOverride x] 28 
protected void onPause() ( 
super.onPause(); 
mAdapter.setDelegate (null); a f£ onPause() F 
) 法 中 取消 注册 委 
aOverride OIZ 
public void removeItem(Integer value) { + ， 从 列表 中 移 除 指定 项 ， 
Msn 然后 通知 适配器 绑 定 
mAdapter.notifyDataSetChange ; O 的 数据 发 / ód 
] AZ 生变 化 


} 


从 代码 中 可 以 看 到 ，Activity 实 现 了 NumbersAdapterDelegate 接 口 @。 我 们 并 没有 在 onCreate () 方法 中 将 当前 Activity 
设置 为 适配器 的 委托 对 象 ， 而 是 在 onResume () 方法 中 注册 代理 对 象 @， 然 后 在 onPause () 方法 中 取消 注册 @。 这 样 做 的 
目的 是 为 了 确保 只 在 Activity 显 示 在 屏幕 上 的 时 候 才 作为 委托 对 象 使 用 。 读 者 可 以 看 看 委托 方法 @， 该 方法 从 列表 中 移 除 指定 
项 ， 然 后 通知 适配器 绑 定 的 数据 友 生 变化 。 


27.1 概要 
委托 模式 在 iOS 开 友 中 被 大 量 使 用 。 比 如 ， 创 建 HTTP 请 求 时 ， 开 友 者 可 以 设置 一 个 委托 对 象 ， 当 请 求 处 理 完 毕 后 指定 一 些 
操作 。 当 编写 iPhone 应 用 程序 时 ， 我 时 刻 注意 使 用 委托 对 象 来 组 织 我 的 代码 。 


本 例 只 是 冰山 一 角 。 委 托 模式 企 Android 开 上 友 过 程 中 的 方方面面 都 有 涉及 。 比 如 ， 读 者 可 以 根据 HTTP 请 求 的 不 同 ， 使 用 委 
托 对 象 采取 不 同 操作 。 请 铭记 ， 只 在 必要 的 时 候 才 使 用 它 。 


27.2. ”外 部 链接 


http://en.wikipedia.org/wiki/Separation of concerns 


http://en.wikipedia.org/wiki/Delegation pattern 


Hack 28 充分 利用 ListView 的 头 视 医 
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有 时 候 ， 开 友 者 需要 基于 设计 师 的 线 框图 (wireframes) 开 友 一 些 怪异 的 布局 。 几 个 月 前 ,我 参与 过 一 个 项 目 ， 这 个 项 目 
的 线 框图 上 方 是 一 个 相册 ， 下 方 是 一 个 列表 。 看 起 来 挺 简单 ， 我 首先 添加 了 一 个 Gallery 控 件 ， 然 后 在 该 控件 下 方 添加 一 个 
ListView 控 件 。 但 是 ， 当 设计 师 看 到 应 用 程序 的 运行 效果 时 ， 他 跑 来 问 我 : “我 希望 界面 能 深 动 到 让 相册 显示 不 出 来 的 位 置 ”。 


在 这 个 Hack 里 ， 我 会 向 读者 展示 我 是 如 何 实现 设计 师 的 需求 的 : 在 界面 上 提供 一 个 显示 图 片 的 相册 和 一 个 显示 数字 的 列 
表 ， 当 向 下 滚动 界面 和 时， 相册 也 会 随 之 浴 动 ， 直 人 到 图 片 消失 。 应 用 程序 的 最 终 效 果 如 图 28-1 所 示 。 


图 28-1 Demo 应 用 程序 


要 实现 这 种 类 型 的 布局 ， 开 发 者 可 能 倾向 于 把 Gallery 和 ListView 这 两 个 控件 置 于 ScrollView 中 ， 但 是 这 是 不 行 的 ， 因 为 
ListView 本 身 束 是 一 种 ScrollView。 读 者 可 以 尝试 上 述 方法 ， 但 是 会 遇 到 很 多 问题 ， 因 为 ListView 中 已 经 处 理 了 滚动 事件 。 





笠 运 的 是 ，ListView 提 供 了 可 以 为 列表 添加 头 视 图 (Header View) 和 尾 视 图 (Footer View) 的 方法 。 下 面 的 代码 演示 如 
何 使 用 这 些 方法 把 Gallery 设 置 为 ListView 的 头 视图 。 


public class MainActivity extends Activity { 


praiyare Static Final Steino] NUMBERS = [*Ll*", "2*. "J"; a- 
al^ a "Ee "ye "a"): 


private Gallery mGallery; 
private View mHeader; 
private ListView mListView; 


aOverride 
public void onCreate(Bundle savedInstanceState) ( 


super.onCreate(savedInstanceState); 获取 Li 
setContentView(R.layout.main); dtl 
Q view 
mListView = (ListView) finadaViewById(R.id.main listview); <4 的 引用 
创建 需要 > LayoutInflater inflator = LayoutInflater.from(this); 
被 填充 的 mHeader = inflator.inflate(R.layout.header, mListView, false); 
XML X mGallery = (Gallery) mHeader.findaViewById (R.id.gallery); 
件 mGallery.setAdapter (new ImageAdapter (this)); 
> ListView.LayoutParams params = 
Er a 3L Td new ListView.LayoutParams(ListView.LayoutParams.FILL PARENT, 
图 的 原 e ListView.LayoutParams.WRAP CONTENT); 将 这 头 视 图 添 
mHeader.setLayoutParams (params); 
y mListView.addHeaderView(mHeader, null, false); <4 MA 
Params 
3; List ArrayAdapter«String» adapter = 
^J 5l new ArrayAdapter«String»(this, R.layout.list item, NUMBERS); 
View ix mListView.setAdapter (adapter); 
置 适配器 一 个 
mListView.setOnlItemClickListener( O` 4s 加 onjtem 
new OnItemClickListener() ( «1 Click Is Ur c 
aOverride 


public void onItemClick(AdapterView«?» parent, View view, 
int position, long id) ( 
mGallery.setSelection(position-1); 


首先 在 代码 中 获取 ListView 的 引用 @@， 该 ListView 会 全 屏 显 示 。 我 们 在 另外 一 个 XML 文件 中 创建 头 视图 ， 然 后 填充 
(inflate) 该 视图 OD。 在 代码 中 ， 读 者 可 以 看 到 ， 我 们 需要 企 头 视图 上 额外 调用 一 次 findViewByld () 方法 ， 这 是 因为 我 们 创 
建 了 一 个 内 部 含有 Gallery 的 LinearLayout。 虽 然 这 并 不 是 必须 的 ， 但 是 后 期 可 能 还 会 添加 其 他 组 件 。 我 们 使 用 ListView 的 
LayoutParams 蔡 换 了 头 视 图 的 初始 LayoutParams@)， 狗 ———— 设置 好 头 视 图 后 ， 我 们 为 
ListView 设 置 适 配器 @。 最 后 ， 为 ListView 添 加 一 个 onltemClick 监 听 器 @， 通 过 该 监听 器 ， 当 点 击 某 个 列表 项 的 数字 时 ， 可 以 
滚动 相册 中 对 应 的 图 片 。 


28.1 概要 


将 绪 框 图 转化 为 真正 的 应 用 程序 是 很 困难 的 ， 如 果 设 计 师 不 清楚 平台 的 限制 和 功能 ， 那 融 更 困难 了 。 开 妈 者 的 工作 残 是 要 用 
尽 可 能 简单 的 方法 和 近 巧 来 解决 这 些 困难 。 我 建议 开 友 者 深入 理解 框 以 层 并 将 其 功能 上 友 挥 到 极限 。 


28.2 ”外 部 链接 


http:;//developer.android.com/reference/android/widget/ListView.html 


http:;//groups.google.com/group/android-beginners/browse thread/thread/2d1a4b8063b2d8f7 


Hack 29 在 ViewPager 中 处 理 转 屏 
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Android 兼 容 性 开发 包 修 订 版 3 (Compatibility Package revision 3) 引入 了 ViewPager 这 个 类 。 即 便 读 者 从 未 使 用 过 
ViewPager， 也 应 该 知道 该 类 可 以 实现 横向 视图 切换 。ViewPager 类 都 有 哪些 功能 呢 ? 该 类 可 以 用 于 创建 任何 需要 显示 分 页 视 
图 的 应 用 程序 。 更 重要 的 是 ， 该 类 的 用 法 与 AdapterView 相 似 ， 使 用 该 类 融 像 使 用 ListView 那 样 简 单 。 


假设 需要 创建 一 个 电子 杂志 风格 [1 的 应 用 程序 。 尽 管 View-Pager 是 实现 这 种 应 用 程序 的 好 帮手 ， 但 是 要 在 不 同 的 分 页 中 分 
别 深 取 不 同 的 横竖 屏 显 示 却 是 比较 困难 的 。 在 这 个 Hack 里 ， 我 会 向 读者 展示 如 何 配置 和 使 用 ViewPager 类 完成 上 述 需 求 。 


为 了 演示 这 个 Hack， 我 创建 了 一 个 颜色 查看 器 应 用 程序 。 该 应 用 程序 可 以 在 不 同 头 色 之 间 切 换 ， 并 且 满 足 
(index%2) ==0 的 分 页 是 横 屏 显示 的 。 为 此 ， 我 创建 了 以 下 组 件 : 


- Activity: 持 有 ViewPaget 的 引用 、 控 制 屏 幕 旋转 

.ColorFragment 类 : 用 于 显示 颜色 ， 并 在 屏幕 中 央 显 示 文 本 内 容 

: ColorAdapterZ&: 负责 创建 Fragment、 通 知 Activity 对 于 哪个 Ftagment 需 要 改变 屏幕 显示 方向 
: ViewPager: 使 用 ColorAdapter 显 示 Fraegment 


接 下 来 分 析 Activity 中 的 代码 逻辑 ， 如 下 所 示 : 


public class MainActivity extends FragmentActivity ( 


private ViewPager mViewPager; 
private ColorAdapter mAdapter; 


QOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


SUL onu, ov zx 
setRequestedOrientation( Q RS DES 
ActivityInfo.SCREEN ORIENTATION PORTRAIT); 二 一 Jj |n] 
setContentView(R.layout.main); 


mViewPager = (ViewPager) findViewById(R.id.pager); + 5| FH View- 
mAdapter = new ColorAdapter(getSupportFragmentManager()); © Pacer 
mViewPager.setAdapter (mAdapter); S 
mViewPager.setOnPageChangeListener(new OnPageChangeListener() ( 
QGOverride 
public void onPageSelected(int position) { 
if (mAdapter.usesLandscape(position)) ( o5 加 监听 内 
allowOrientationChanges(); 
) else ( 
enforcePortrait(); 
} 
} 
)); 
) @ 实现 方法 
public void allowOrientationChanges() { < 一 一 


setRequestedOrientation(ActivityInfo.SCREEN ORIENTATION SENSOR); 
) 


public void enforcePortrait() ( 
setRequestedOrientation(ActivityInfo.SCREEN ORIENTATION PORTRAIT); 


PHEA RAAEN SRO, BUSRAMEEUSEESIBAERE E SSERBMGEBRESJJIM), WUSrBRhRIWUZAEE. RBHS 
ViewPager 的 引用 @， 我 们 会 为 其 设置 ColorAdapter。 此 外 还 需要 添加 一 个 监听 器 人 @@ 用 于 监听 页 面 切换 。 在 该 监 听 器 中 会 通过 
适配器 判断 是 否 需 要 改变 屏幕 方向 。 最 后 需要 实现 几 个 方法 @， 这 些 方法 调用 Activity 类 提供 的 setRequestedOrientation () 
方法 改变 屏幕 方向 。 





[1] 可 以 参照 Google Currents 应 用 程序 。 译 者 注 


29.1 概要 
ViewPager 类 是 Android 用 于 水 平视 图 切换 的 标准 实现 。 更 重要 的 是 ， 该 类 可 以 向 后 兼容 到 APl level 4， 也 即 Android 
1.6。 如 果 读 者 从 未 使 用 过 该 类 ， 可 以 党 试 下 ， 这 个 类 值得 掌握 。 


此 外 ， 在 这 个 Hack 里 ,读者 可 以 看 到 在 视图 中 如 何 限 制 屏幕 方向 改变 。 请 记 住 : 最 好 每 个 视图 都 可 以 支持 两 种 不 同 的 屏幕 
方向 ， 当 用 户 使 用 应 用 程序 的 时 候 ， 如 果 可 以 改变 屏幕 方向 ， 会 提升 用 尸体 验 。 


| ndroid E l m/2011, orizontal iping-witl jer.htn 
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Hack 30 ” ”ListView 的 选择 模 3 
Android v1.6-- 


ListViewz&Android SDK 中 提供 的 最 重要 的 类 之 一 。 除 了 可 以 在 滚动 列表 中 显示 数据 项 外 ， 访 类 还 可 以 用 于 从 列表 中 选择 数 
据 项 。 假 设 要 创建 一 个 Activity， 通 过 该 Activity， 用 户 可 以 从 列表 中 选择 一 个 国家 。 应 该 如 何 实现 这 个 功能 呢 ? 开发 者 会 自己 处 
理 选择 的 功能 吗 ? 开发 者 可 以 创建 一 个 ListView， 然 后 使 用 一 个 点 击 处 理 器 处 理 选择 的 功能 ,但 是 ， 在 这 个 Hack 里 ,我 会 提供 
一 个 更 简单 的 万 法 。 

在 这 个 Hack 里 ， 读 者 会 掌握 如 何 使 用 ListView 创 建 一 个 国家 选择 器 。 该 选择 器 的 运行 效果 如 图 30-1 所 示 。 当 选择 了 一 个 国 
XAJ, Exi "Pick Country” 按 钮 ， 融 会 在 Toast 中 显示 出 国家 名 。 
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Pick Country 


Anguilla 


Antarctica 


Antigua and Barbuda 





Argentina 


Armenia 
Aruba 
Australia 


Austria 


Azerbaijan 





图 30-1 国家 选择 器 
ListView 定 义 了 choiceMode 属 性 。 开 发 文档 (1130.25) 对 该 属性 的 解释 如 下 : 


“用 于 为 视图 定义 选择 行为 。 默 认 情 况 下 ， 列 表 是 没有 任何 选择 行为 的 。 如 果 把 choiceMode 设 置 为 singleChoice， 列 表 允 许 有 
一 个 列表 项 处 于 被 选 状态 。 如 果 把 choiceMode 设 置 为 multipleChoice， 那 么 列表 允许 有 任意 数量 的 列表 项 处 于 被 选 状态 。 ” 


在 本 例 中 ， 我 们 把 choiceMode 设 置 为 singleChoice。 如 果 需 要 列表 多 选 ， 就 设置 为 multipleChoice。 


ListView 另 外 一 个 有 趣 的 功能 是 : 不 管 使 用 singleChoice 还 是 multipleChoice， 所 选 列 表 项 的 位 置信 息 都 会 被 自动 保 行 。 现 
在 ， 读 者 已 经 知道 设置 choiceMode 为 singleChoice 便 可 以 为 ListView 创 建 选择 器 ， 接 下 来 我 们 创建 Activity 的 布局 文件 ， 源 码 
如 下 所 示 : 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«Button 
android:layout width-"fill parent" 使 用 按钮 
android:layout height-"wrap content" 来 执行 指 
android:onClick-"onPickCountryClick" 定 的 方法 


android:text-"Gstring/activity main add selection" /> 


«ListView 
android:id-"QG-«-id/activity main list" 
android:layout width-"fill parent" nen 
1 M E 1 I 1 "d " 显示 国家 
android:layout height-"fill parent 
android:choiceMode-"singleChoice" /> 列表 


</LinearLayout> 


布局 文件 比较 简单 。 使 用 按钮 @ 来 执行 指定 的 方法 ， 访 方法 用 于 获取 所 选 的 国家 。 此 外 ， 我 们 使 用 一 个 选择 模式 设置 为 
singleChoice@ 的 ListView 来 显示 国家 列表 。 


现在 创建 列表 项 的 布局 文件 以 及 Activity 的 源 代码 。 列 表 项 的 布局 文件 如 下 所 示 : 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" > 


«TextView 
android:id-"QG«id/country view title" 
android:layout width-z"Odp" 
android:layout height-"wrap content" 
android:layout weight-z"0.9" 
android:padding-"10dp" /> 


«CheckBox 
android:id-"QG«id/country view checkbox" 
android:layout width-"Odp" 
android:layout height-"wrap content" 
android:layout weight-"0.1" 
android:gravity-"center vertical" 
android:padding-"10dp" /> 


«/LinearLayout-» 


Activity 的 源码 如 下 所 示 : 


public class MainActivity extends Activity ( 
private ListView mListView; 
private CountryAdapter mAdapter; 
private List«Country» mCountries; 
private String mToastFmt; 


QGOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); [n] yI) 3e rH Ji 35 
setContentView(R.layout.activity main); a.p - p 
mad nic 国家 信息 的 辅 
createCountriesList(); < 助 方法 
mToastFmt = getString(R.string.activity main toast fmt); 
mAdapter - new CountryAdapter(this, -1, mCountries); 
mListView = (ListView) 
findViewById(R.id.activity main list); 二 创建 适配器 
mListView.setAdapter (mAdapter); 并 设置 给 
} 
ListView 
public void onPickCountryClick(View v) ( li] e T SEA ER] 
int pos - mListView.getCheckedItemPosition(); NA ON 
A. Wb Æ Toast 中 
if (ListView.INVALID POSITION !- pos) ( < 一 显示 国家 名 称 
String msg = String.format(mToastFmt, mCountries.get(pos) 
.getName()); 


Toast.makeText(this, msg, Toast.LENGTH SHORT).show(); 


看 起 来 比较 简单 ， 是 吧 ” 上 述 代码 确实 简单 ， 但 是 有 一 个 近 巧 需要 掌握 。 读 者 需要 理解 ListView 是 如 何 将 采 个 位 置 设 置 为 已 
选 或 者 未 选 ， 并 正确 使 用 它 。 


此 时 ， 如 果 读 者 通过 网 络 搜索 ListView 的 choiceMode 相 关 信 息 ， 会 友 现 多 数 代 码 使 用 了 CheckedTextView 类 作为 列表 项 
的 视图 ， 这 与 本 例 中 使 用 自 定 义 视 图 有 所 不 同 。 如 果 读 者 分 析 CheckedTextView 类 的 源 代 码 ， 便 会 友 现 该 类 是 TextView 的 子 
类 ， 并 上 且 实现 了 Checkable 接 口 。 


因此 ListView 以 某 种 方式 通过 Checkable 接 口 来 处 理 视图 的 选择 状态 。 如 果 读 者 分 析 过 ListView 的 源码 ， 就 会 上 发 现下 述 代 
1B: 
if (mChoiceMode !- CHOICE MODE NONE && mCheckStates !- null) ( 


if (child instanceof Checkable) ( 
((Checkable) child).setChecked(mCheckStates.get(position)); 


如 果 需 要 ListView 处 理 选择 行为 ， 需 要 令 列 表 项 对 应 的 自 定 义 视 图 实现 Checkable 接 口 。 遗 憾 的 是 ， 这 种 方式 必须 创建 自 定 
义 视图 。 我 们 创建 CountryView 类 ， 其 源码 如 下 所 示 : 


public class CountryView extends LinearLayout 
implements Checkable ( 


private TextView mTitle; 


private CheckBox mCheckBox; 


public CountryView(Context context, AttributeSet attrs) ( 
super(context, attrs); 


no LayoutInflater inflater - LayoutInflater.from(context); 
HL View v - inflater.inflate(R.layout.country view, this, true); 
布局 mTitle = (TextView) v.findViewById(R.id.country view title); 
mCheckBox - (CheckBox) v.findViewById(R.id.country view checkbox); 
} 


public void setTitle(String title) ( 
mTitle.setText(title); 


重 写 所 有 Check- 
QGOverride able 接口 的 方法 
public boolean isChecked() { < 一 一 

return mCheckBox.isChecked(); 
} 
QGOverride 


public void setChecked(boolean checked) ( 
mCheckBox.setChecked(checked) ; 


} 


QOverride 
public void toggle() ( 
mCheckBox.toggle(); 


注意 代码 中 是 如 何 实现 Checkable 接 口中 定义 的 方法 的 。 每 个 被 实现 的 接口 方法 中 都 调用 了 mcCheckBox 的 相应 方法 。 这 意 
味 着 ， 在 ListView 中 选择 一 行 时 ， 会 调用 CountryView 的 setChecked () 方法 。 


一 切 准 备 束 绪 ， 可 以 运行 应 用 程序 了 。 读 者 会 友 现 当 点 击 某 行 时 ，CheckBox 中 并 没有 打 勾 ， 但 是 当 点 击 CheckBox 


时 ，CheckBox 惑 会 打 勾 。 甚 至 还 会 友 现 ， 可 以 选择 多 行 。 哪 里 出 问题 了 ?” 


问题 出 在 我 们 添加 了 一 个 可 获取 焦点 的 UI 控 件 CheckBox。 解 决 上 述 问 题 的 最 好 方法 便 是 不 允许 CheckBox 获 取 焦 点 。 此 
外 ， 由 于 ListView 才 是 决定 某 项 是 否 可 选 的 主角 ， 因 此 还 需要 将 CheckBox 设 置 为 不 可 点 击 。 要 实现 上 述 需求 ， 可 以 在 XML 文 件 
中 添加 如 下 代码 : 


android:clickable="false" 
android: focusable="false" 
android: focusableInTouchMode="false" 


添加 上 述 修改 后 ， 重 新 运行 应 用 程序 ， 此 时 便 会 看 到 期 望 的 效果 。 


30.1 概要 


这 个 Hack 解 决 了 Android 开 发 文档 含 渴 不 清 而 引入 的 一 个 问题 。 要 正确 使 用 ListView 的 choiceMode 属 性 ， 需 要 阅读 SDK 源 
代码 ， 但 是 一 旦 理解 了 其 运行 原理 ， 开 发 者 就 掌握 了 一 项 很 不 错 的 特性 ， 当 需要 从 列表 中 选择 一 个 或 者 多 个 列表 项 的 时 候 ， 这 项 
特性 就 派 上 用 场 了 。 


30.2 ”外 部 链接 


http://developer.android.com/reference/android/widget/AbsList-View.html#attr android:choiceMode 


http://stackoverflow.com/questions/5612600/listview-with-choice-mode-multiple-using-checkedtext-in-a- 


custom-view 
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绍 通过 添加 这 些 库 会 为 应 用 程序 引入 哪些 潜在 功能 。 


Hack 31 Android 面 向 切面 编程 


Android v1.0 十 


读者 有 过 在 Android 的 Activity 中 添加 分 析 、 广 告 以 及 日 志 代 码 的 经 历 吧 ? 如 果 有 过 这 样 的 经 历 ， 你 会 发 现 Activity 被 很 多 与 
其 自身 逻辑 无 关 的 代码 “污染 ”了 。 在 这 个 Hack 里 ， 读 者 会 看 到 如 何 使 用 面向 切面 编程 (Aspect-Oriented 
Programming, AOP) 解决 上 述 问 题 。 在 本 例 中 ， 我 会 使 用 AOP 的 方式 在 Activity 的 onCreate () 方法 中 添加 日 志 语 句 以 避免 


Activity 被 “污染 ”。 


面向 切面 编程 是 一 种 编程 范式 ， 通 过 分 离 横 切 关注 点 (Cross-cutting Concern) 提高 程序 的 模块 化 和 组 件 化 。 其 基本 原 
理 是: 将 横 切 关注 点 抽 离 到 一 个 单独 的 模块 (切面 牛 ，Aspect) 中 ， 同 时 将 需要 执行 的 业务 逻辑 代码 (或 者 在 横 切 关注 点 之 前 
或 者 在 横 切 关 注 点 之 后 ) 放 在 单独 或 者 不 同 模块 中 。 图 31-1 演 示 了 上 述 概念 。 


OOP OOP + AOP 


+ Logging Security 


Activity 
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Activity Aspects 


图 31-1 AOP 模 块 化 


在 Android 中 可 以 使 用 AspectJ 这 个 库 来 实现 面向 切面 编程 。 瞧 于 Android 不 支持 字 节 人 码 生 成 ， 我 们 无 法 使 用 AspectJ 的 所 有 
特性 ， 但 是 Android 支 持 Aspect 提 供 的 编译 时 织 入 (compile-time weaving) 的 特性 。 要 理解 该 特性 ， 首 先 需 要 理解 编译 时 织 
入 的 时 机 。AspectJ 可 以 在 代码 被 编译 成 字 节 码 之 后 ， 转 换 为 dex 之 前 修改 代码 。 对 于 本 例 ，AspectJ 负 责 向 横 切 关注 点 追加 代 
码 ， 如 图 31-2 所 示 。 


要 让 AOP 运 行 起 来 ， 需 要 修改 编译 过 程 。 对 于 本 例 ， 我 们 使 用 Apache Maven 工 具 ， 使 用 该 工具 ， 只 需要 在 pom.xml 文 件 
中 添加 依赖 关系 和 构建 (build) 插件 ， 剩 下 的 就 很 简单 了 。 


我 们 使 用 的 Apache Maven 插 件 是 aspectj-maven-plugin， 下 面 看 看 如 何 企 pom.xml 文 件 中 配置 该 插件 : 





Activity N / Aspect 





Activity 


图 31-2 AOP 构 建 过 程 


«plugin» 
«groupId»org.codehaus.mojo«/groupId» 
«artifactlId»aspectj-maven-plugin-c/artifactId» 
«version»1.4«/version» 
«configuration» 
«source»1.5«/source» 
«complianceLevel»1.5«/complianceLevel» 
«showWeaveInfo»truec/showWeaveInfo» < £ 开局 showWeavelInfo 
«verbose»true-c/verbose» 4 @ 开局 verbose 
</configuration> 
<executions> 
«execution» 
«goals» 
«goal»compile«/goal» < € goal b A Y E 为 complle 
«/goals» 
«/execution» 
«/executions» 
«/plugin» 


开发 切面 时 ， 需 要 将 showWeavelnfo@ 和 verbose@O 标 记 设 置 为 开局， 这 样 会 打印 织 入 过 程 的 日 志 人 信息， 有 助 于 理解 该 过 
程 的 执行 流程 。 将 goalB] 设 置 为 compile@， 插 件 会 织 入 main 目 录 欠 下 的 类 ， 如 果 我 们 还 需要 织 入 test 目 录 下 的 类 ， 就 需要 添加 


<goal>test-compile</goal> 配 置 。 


我 们 并 没有 指定 源 代码 的 路 径 ， 因 此 AspectJ 插 件 会 搜索 src/main/ 目 录 下 的 文件 。 在 上 述 目 录 下 ， 我 们 创建 java 目 录 和 
aspectEi&, 435ltziiJavat VIT V3. 


现在 已 经 做 好 了 所 有 配置 ， 可 以 在 项 目 中 使 用 Aspectj 了 。 因 为 要 从 Activity 中 移 除 日 志 ， 因 此 需要 创建 一 个 日 志 切 面 。 创 建 
切面 的 方式 有 两 种 : 使 用 AspectJ 语 法 或 者 @AspectJ 注 解 (Annotation) 。 两 种 方式 最 大 的 不 同 之 处 在 于 : 使 用 AspectJ 语 法 
更 易 编写 切面 ， 因 为 该 语法 就 是 为 了 编写 切面 而 设计 的 ， 但 是 注解 风格 遵循 常规 的 Java 编 译 器 。 我 们 不 需要 实现 很 复杂 的 功能 
切面 比较 简单 ， 因 此 本 例 使 用 注解 风格 创建 切面 。 


在 aspect 目 录 下 ， 有 一 个 LogAspectjava 文 件 ， 该 文件 用 于 摘 述 切面 : 
GAspect Aspect) 注解 
public class LogAspect { 


aPointcut("within(com.manning.androidhacks.hack031.MainActivity)") 
private void mainActivity() ( 


) @ 用 于 Activity WIA xi 
QGPointcut("execution(* onCreate(..))") < 用 于 onCreate() 77 
private void onCreate() { Ox 
} 
A HE @AfterReturning (pointcut = "mainActivity() && onCreate()") 
A o public void logAfterOnCreateOnMainActivity() ( 
Z NAS Log.d("TAG", "OnCreate() has been called!"); « O 执行 
j Advice 


ARS TKIRRHINAspecU, TAJLA AERE EMRA : 


连接 点 (Join Point) 是 程序 执行 流程 中 某 个 确定 的 执行 点 。 


` 切入 点 中 (Pointcut) 用 于 辨别 确定 的 连接 点 以 及 该 连接 点 的 取 值 。 
通知 (Advice) 是 到 达 一 个 连接 点 时 要 执行 的 代码 。 


我 们 使 用 注解 风格 创建 切面 ， 因 此 需要 使 用 @AspectQ 为 类 添加 注解 。 类 中 前 两 个 方法 使 用 @Pointcut 注 解 。 本 例 中 ， 第 
一 个 @Pointcut 注 解 为 MainActivity 类 @ 创 建 一 个 切入 上 后， 第 二 个 @Pointcut 注 解 为 任意 名 为 onCreate () 的 方法 @ 创 建 一 个 
切入 点 。 第 三 个 方法 是 一 个 通知 (Advice) ， 我 们 使 用 @AfterReturning 注 解 该 方法 ， 与 该 注解 匹配 的 方法 正常 返回 后 该 通知 
束 会 执行 。 留 意 代 码 中 是 如 何 通 过 && 运 算 符 @ 合 用 mainActivity () 和 onCreate () 这 两 个 切入 点 的 。 当 代码 执行 到 指定 的 连 
接点 ，Advice 对 应 的 代码 就 会 被 执行 @。 


决定 连接 氮 的 方式 有 多 种 。 本 例 中 ， 我 们 合用 两 个 切入 点 ， 读 者 也 可 以 通过 其 他 万 法 实现 相同 功能 。 根 据 具 体 需求 ， 开 妈 者 
需要 灵活 处 理 连 接点 和 通知 。 


[] 面向 切面 编程 涉及 很 多 抽象 概念 ， 可 以 将 横 切 关注 点 理解 为 与 核心 业务 逻辑 无 关 ， 可 以 在 多 个 模块 中 出 现 的 辅助 还 辑 ， 比 如 
权限 验证 、 日 志 记 录 等 。 





译 者 注 

[2] 切面 ， 即 Aspect 是 面向 切面 编程 的 核心 概念 ， 用 于 封装 横 切 关注 点 。 
[3] goal 是 Maven 中 的 执行 任务 。 译 者 注 

[4] main 目 录 和 test 目 录 是 Maven 的 标准 目录 结构 。 译 者 注 

[5] 可 以 把 切入 点 视 为 特定 连接 点 的 表达 形式 ， 表 示 当 前 切面 适用 于 哪个 连接 点 。 





译 者 注 











译 者 注 


31.1 概要 


本 例 展示 了 如 何 使 用 Aspect 提 供 的 编译 时 织 入 的 特性 为 Activity 中 的 万 法 添加 日 志 ， 但 是 还 要 想 想 其 他 潜在 功能 。 不 要 仪 仪 
把 AOP 视 为 一 种 把 代码 从 一 个 类 转移 到 另 一 个 类 的 方式 。 好 好 检查 应 用 程序 的 设计 ， 分 析 如 何 通过 AOP 提 高 代码 的 模块 化 。 


31.2 ”外 部 链接 


http://en.wikipedia.org/wiki/Aspect-oriented programming 
http://eclipse.org/aspectj/doc/released/faq.php 
http://mojo.codehaus.org/aspectj-maven-plugin/ 
http://williamd1618.blogspot.com/2011/04/android-and-aspect-oriented-programming.html 


www.eclipse.org/aspectj/doc/next/progguide/starting-aspectj.html 


Hack 32 使 用 Cocos2d-x 美 化 应 用 程序 


Android v2.2 十 


Android 提 供 了 多 种 方式 向 用 户 展示 应 用 程序 信息 ， 但 是 很 多 时 候 这 些 方式 是 不 够 的 。 假 设 读者 想 为 应 用 程序 添加 图 形 视 图 
或 者 3D 动 画 ， 应 该 怎么 做 呢 ? 一 些 开发 者 可 能 会 尝试 使 用 OpenGL 开 发 视图 ， 但 是 这 意味 着 为 应 用 程序 增加 了 一 层 复杂 的 代 
码 ， 而 且 并 不 是 所 有 人 都 熟悉 OpenGL.。 


在 这 个 Hack 里 ， 我 会 向 读者 展示 如 何 使 用 Cocos2d-x 这 个 游戏 框架 为 应 用 程序 添加 新 的 特性 。 


Cocos2d 原 本 是 PyWeek 游 戏 编程 竞赛 中 使 用 的 Python 游 戏 框 架 。Cocos2d 的 名 字 来 源 于 阿根廷 科 尔 多 瓦 一 个 叫 Los 
Cocos 的 城市 。 后 来 ，Cocos2d 的 创造 者 之 一 Ricardo Quesada 用 Objective-C 语 言 开 发 了 iPhone 版 本 的 Cocos2d。 该 版 本 要 比 
Python 版 本 知名 的 多 ， 症 果 应 用 程序 商店 中 有 大 量 游戏 使 用 了 该 版 本 的 Cocos2d。 有 人 玩 过 粉碎 僵尸 (Zombie Smash) 或 者 
喂 我 石油 (Feed Me Oil) 等 洲 戏 大 作 吗 ? 这 些 作品 束 是 使 用 Cocos2d 编 写 iPhone 游 戏 的 成 功 案例 ， 它 们 都 曾 高 居 iPhone 付 费 
应 用 程序 排行 榜 的 榜 百 。 


Cocos2d-x 是 iPhone 版 Cocos2d 的 C++ 移植 版 本 。 该 版 本 具有 跨 平 台 、 轻 量 级 、 对 开 友 人 员 友 好 、 免 费 、 开 源 等 优点 。 此 
外 ， 读 者 可 以 猜 猜 还 会 有 什么 优点 ?还 有 一 个 优点 就 是 可 以 通过 Android NDK 使 用 该 版 本 。 


为 了 演示 Cocos2d-x 的 功能 ， 我 会 创建 一 个 Android 应 用 程序 显示 下 雪 的 效果 。 通 过 雪人 花 颗 粒 ， 我 们 为 视图 加 入 了 寒冷 的 视 
网 效果 。 应 用 程序 的 运行 结果 如 图 32-1 所 示 。 


初学 者 应 该 知道 Cocos2d-x 使 用 OpenGL 绘 图 。 在 Android 中 ， 通 过 OpenGL 绘 图 ， 开 发 者 需要 使 用 SurfaceView。 接 下 
来 ， 我 们 先 看 看 SurfaceView 的 工作 原理 ， 然 后 再 理解 如 何 将 Cocos2d-x 植 入 应 用 程序 中 。 





+ 


图 32-1 显示 下 雪 效 果 的 应 用 程 友 
在 开 帮 文档 的 SurfaceView 相 天 部 分 ( 见 32.4 节 ) ， 有 下 面 一 段 摘 述 : 


“SutfaceView 是 View 的 特殊 子 类 ， 用 于 在 视图 层次 结构 中 提供 一 个 专用 的 绘图 Surface。 其 目的 是 将 这 个 绘图 Surface 提 供给 应 
用 程序 的 另外 一 个 线程 中 ， 这 样 应 用 程序 界面 就 不 必 等 待 到 系统 视图 层次 结构 做 好 绘制 准备 的 时 候 。 相 反 ， 另 外 一 个 线程 持 有 
SutfaceView 的 引用 ， 可 以 根据 自己 的 步调 向 自身 的 Canvas 中 绘制 


最 后 一 段 话 蕴含 的 信息 很 多 ， 让 我 用 一 种 更 简单 的 方式 解释 这 段 话 。 我 们 向 应 用 程序 中 添加 的 UI 控件 或 者 自 定义 视图 会 被 
加 入 到 视图 层次 中 。 完 整 的 视图 树 (Activity 的 表现 形式 ) 是 在 UI 线程 中 绘制 的 。 另 一 方面 ，SurfaceView 在 自己 的 线程 中 绘 
制 ， 并 不 会 用 到 UI 线程 。 如 果 SurfaceView 不 通过 UI 线程 绘制 自身 ， 那 么 ，Android 如 何 将 视图 层次 和 SurfaceView 整 合 到 一 
起 ? 要 理解 这 个 问题 ， 必 须 分 析 下 面 这 段 话 ( 见 32.4 节 ) : 


“Sutface 是 以 Z 轴 排序 的 (z-order) ， 以 至 其 位 于 SurfaceView 宿 主 窗口 的 后 方 。SurfaceView 在 窗口 上 开 了 一 个 “ 洞 ， 这样 





Sutface 就 可 以 显示 出 来 了 。 视 图 层次 会 将 其 与 SurfaceView 的 兄弟 节点 正确 合成 ， 这 些 兄 弟 节 点 会 显示 在 Sutface 的 上 方 。 这 个 特性 
可 以 用 于 在 Surface 上 方 放置 覆盖 式 控件 (Overlay) ， 比 如 显示 在 Sutface 上 方 的 按钮 。 有 一 点 需要 注意 ， 如 果 在 Sutrface 上 方 有 全 透 
明 控 件 ， 那 么 每 当 Sutface 发 生变 化 时 ， 这 些 全 透明 的 控件 就 会 重新 合成 ， 这 样 会 影响 性 能 。 C 


从 上 面 这 段 话 可 以 得 出 一 个 重要 结论 : 可 以 合成 两 个 “世界 ”的 内 容 ， 但 是 却 有 一 些 限制 。SurfaceView 既 可 以 放置 在 视图 
层次 的 前 面 也 可 以 放置 在 后 面 。 在 本 例 中 ， 我 们 会 把 视图 层次 放置 在 后 面 ， 而 把 SurfaceView 有 放置 在 前 面 。 接 下 来 首先 创建 视图 


s 
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首先 要 为 Activity 创 建 XML 布局 文件 ， 源 码 如 下 所 示 : 


«?xml version-"1.0" encoding-"utf-8"?» 
«RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" > 


«TextView android:id-"QG«id/winter text" 
android:layout width-z"fill parent" 
android:layout height-2"wrap content" 
android:layout alignParentTop-"true" 
android:layout marginTop-2"5dp" 
android:gravity-"center" 
android:text-"Hello Winter!" 
android:textSize-"30sp" /» 


«View android: id="@+id/separator" 
android:layout_width="fill_parent" 
android:layout height-"5dp" 


android:layout below-2"Gid/winter text" 
android:background-"£FFFFFF" /> 


«TextView android:layout width-"fill. parent" 
android:layout height-2"wrap content" 
android:layout centerInParent-"true" 
android:layout marginTop-"5dp" 
android:gravity-"center" 
android:text-"It's snowing!" 
android:textSize-"30sp" /» 


«FrameLayout android:layout width-"fill parent" 二 & FrameLayout 
android:layout height-"fill parent" 
android:layout below-"Gid/separator"» 


创建 org.coco2dx.lib. 


«org.cocos2dx.lib.Cocos2dxEditText Cocos2dxEditText 
android:id-"QG«-id/game edittext" < 
控件 


android:layout height-2"wrap content" 


android:layout width-"fill, parent" TE XML x 件 中 
android:background-"Gnull"/» l 


放 Er Surface View 
<org.cocos2dx.lib.Cocos2dxGLSurfaceView < 控件 


android:id="@+id/game_gl_surfaceview" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent"/> 
</FrameLayout> 
</RelativeLayout> 


述 布局 中 没有 什么 特别 内 容 ， 我 使 用 RelativeLayout 来 组 织 布 局 中 的 各 个 视图 。 有 趣 的 内 容 在 FrameLayout 中 国 。 首 先 


T E 当 游 戏 需要 用 户 输 入 信息 时 ，Cocos2d-x 通 过 
Cocos2dxEditText 显 示 一 个 输入 界面 ， 我 们 不 会 用 到 该 界面 ， 但 还 是 有 必要 添加 它 。 另 外 一 个 重要 组 件 是 SurfaceView@。 在 
布局 文件 中 放置 SurfaceView 是 一 种 定位 Cocos2d-x 视 图 ， 并 提供 其 宽 高 尺寸 的 独特 方式 。 本 来 我 们 可 以 全 屏 显 示 ， 但 是 我 想 辣 
读者 展示 如 何 利 用 Android 资 源 在 屏幕 上 显示 SurfaceView， 而 不 需要 考虑 设备 尺寸 、 像 素 密度 等 信息 。 


接 下 来 继续 分 析 Activity 的 代码 。 这 段 代 码 直 接 从 Cocos2d-x 的 Hello World 示 例 程序 中 拷贝 而 来 ， 源 码 如 下 所 示 : 


public class MainActivity extends Cocos2dxActivity ( < 继承 日 Cocos2- 
private Cocos2dxGLSurfaceView mGLView; dxActivity 
protected void onCreate(Bundle savedlInstanceState) ( 
super.onCreate(savedInstanceState); gp vm 
"ni n E 
if (detectOpenGLES20()) ( 5 EL HH FEN 
String packageName = getApplication().getPackageName(); aA 包 名 
super.setPackageName (packageName) ; 

: . 为 Cocos2d- 提供 
setContentView(R.layout.game demo); i „OCOS X PEIX 
mGLView = (Cocos2dxGLSurfaceView) Cocos2dxEditText 

findViewById(R.id.game gl surfaceview); Y fob dus > 
al 1l WEN ( 1 9 gl su V1 "m 控件 的 位 置 
Cocos2dxEditText edittext = (Cocos2dxEditText) 


findViewById(R.id.game edittext); 


mGLView.setEGLContextClientVersion(2); 
mGLView.setCocos2dxRenderer(new Cocos2dxRenderer()); 
mGLView.setTextField(edittext); 


) else { 
Log.d("activity", "do not support gles2.0"); 


en «— @ 关闭 应 用 程序 


要 在 Activity 中 使 用 Cocos2d-x 的 特性 ， 需 要 继承 自 Cocos2-dxActivity 四 。 我 们 要 告诉 Cocos2d-x 应 用 程序 的 包 名 是 什么 
@)，Cocos2d-x 会 使 用 该 包 从 assets 文 件 夹 中 读 取 asset 资 源 。 我 们 还 需要 为 Cocos2d-x 提 供 Cocos2dxEditText 控 件 的 位 置 @)。 
如 果 设 备 不 支持 OpenGL 2.0， 那 么 就 关闭 应 用 程序 @。 


在 这 里 ， 我 们 冒昧 地 修改 Cocos2d-x 的 Java 代 码 ， 令 Surface-View 显 示 在 视图 层次 的 上 方 ， 并 使 其 背景 为 半 透 明 状 态 。 要 
实现 这 种 效果 ， 需 要 人 在 Cocos2dxGLSurfaceView 类 的 initView () 方法 中 添加 如 下 几 行 代码 : 


setEGLConfigChooser(8, 8, 8, 8, 16, 0); 
getHolder().setFormat(PixelFormat.TRANSLUCENT); 
setZOrderOnTop(true); 


此 外 ， 还 需要 在 Cocos2dxRenderer 类 的 onSurfaceCreated () 方法 中 添加 如 下 代码 行 


gl.glClearColor(0, 0, 0, 0); 


HrfJavaf RE ESSI. SERIE, KRAECH HRANE TEAR. SFAR EA amn EE, HEB 
接 拷 由 粘贴 了 Cocos2d-x 提 供 的 一 个 与 下 雪 效 果 有 关 的 粒子 系统 的 测试 例子 。 所 有 代码 都 在 HelloWorldScene.cpp 文 件 中 ， 读 
者 可 以 在 本 书 的 示例 代码 中 找到 该 文件 。 


如 果 读 者 之 前 并 未 在 Android 中 使 用 C++ 语言 ， 那 么 你 应 该 知道 需要 使 用 Android NDK, 





[1] 非 UI 线 程 。 译 者 注 


32.3 ”概要 


使 用 Cocos2d-x 不 但 可 以 美化 应 用 程序 外 观 ， 还 可 以 避免 直接 操作 OpenGL。 其 不 足 之 处 在 于 需要 处 理 一 些 限 制 和 复杂 性 。 
开发 者 需要 编写 C++ 代 码 ， 并 且 使 用 NDK， 此 外 还 需要 创建 视图 并 正确 处 理 SurfaceView。 不 过 ， 这 些 付 出 是 值得 的 。 


324 ”外 部 链接 


http://developer.android.com/sdk/ndk/index.html 

http://www.cocos2d-x.org/ 
http://developer.android.com/guide/topics/graphics/index.html#on-surfaceview 
http://www.cocos2d-iphone.org/archives/888 
http://www.cocos2d-iphone.org/archives/1496 
http://developer.android.com/guide/topics/graphics/2d-graphics.html 


http://developer.android.com/reference/android/view/Surface-View.html 


Pem ”与 其 他 编程 语言 交互 


Android 应 用 程序 主要 用 Java 语 言 编写 。 此 外 ， 官 方 提供 了 Android NDK (Native Development Kit， 原 生 开 发 套件 ) 支 
持 C/C+ + 语言 。 那 么 ， 除 此 之 外 ， 还 可 以 用 其 他 编程 语言 开发 应 用 程序 吗 ? 本 章 ， 我 们 便 回 答 这 个 问题 。 


Hack 33 ”在 Android 上 运行 Objective-C 


Android v1.6+ 


2011 年 夏天 ， 我 们 公司 发 布 了 一 款 名 为 萨 满 巫 医 (Shaman Doctor) 的 iOS 游 戏 ， 该 游戏 使 用 cocos2d-iphone 库 开发 ， 这 
是 一 个 iOS 库 。cocos2d-iphone 库 使 用 Objective-C 语 言 实 现 ， 但 是 很 多 分 文 项 目 用 其 他 编程 语言 也 实现 了 相同 的 AP1， 其 中 最 
活跃 的 分 文 是 cocos2d-x。cocos2d-x 并 非 用 Objective-C 语 言 实现 ， 而 是 用 C++ 语言 实现 。 最 有 趣 的 是 cocos2d-x 提 供 的 API 很 


像 Objective-C 风 格 。 要 了 解 Cocos2d-x 的 概 狗 ， 请 看 下 述 代码 : 


cocos2d —» [[SimpleAudioEngine sharedEngine] playEffect:G"sfx.file"]; 
iphone SimpleAudioEngine::sharedEngine()-»playEffect("sfx.file"); «— cocos2d-x 
版 本 版 本 


你 也 许 已 经 注意 到 了 ， 两 个 版 本 的 API 几 乎 是 相同 的 。 但 是 ， 如 果 要 把 游戏 从 cocos2d-iphone 移 植 到 cocos2d-x， 需 要 将 
所 有 Objective-C 代 码 移植 为 C++ 代码 ， 这 是 一 项 很 无 聊 的 工作 。 


于 是 我 开始 寻找 茶 代 方案 ， 我 找到 了 Dmitry skiba 创 建 的 名 为 ltoa 的 库 。 为 了 理解 ltoa 的 基本 概念 ， 我 引用 了 其 开 上 友 文 档 
(1133.55) 中 的 一 段 话 : 


[tod 是 一 组 托管 于 GitHub 的 开源 项 目 ， 该 项 目 实现 了 编译 器 、 构 建 脚本 (build script) 和 各 种 库 ， 用 于 将 Objective-C 源 代 
码 构 建 为 Android APK 文 件 。” 


|toa 的 主要 目的 不 仪 限 于 在 Android 平 台 运 行 Objective-C 代 码 ， 它 可 以 神奇 地 将 iOS 应 用 程序 转换 为 Android 应 用 程序 。 虽 
然 其 主要 特性 还 远 未 完成 ， 但 是 在 Android 平 台 运 行 Objective-C 代 码 的 特性 却 已 经 实现 。 


在 这 个 Hack 里 ,我 们 会 移植 一 个 简单 的 Objective-C 库 ， 这 个 库 名 为 TextFormatter。 这 意味 着 不 必修 改 该 库 束 可 以 在 
Android 平 台 运 行 Objective-C 代 码 。 


基础 知识 : NDK 和 OBJECTIVE-C Itoa 大 量 使 用 了 Android NDK。 只 有 理解 NDK 的 原理 ， 才 能 理解 下 文 的 内 容 。 如 果 从 未 使 
用 过 Android NDK， 读 者 可 以 通过 《Android in Action, 3rd Edition? (W.Frank Ableson 等 ，Manning 出 版 社 ，2011) 这 本 书 学 习 这 


部 分 内 容 。 此 外 ， 还 需要 具备 Objective-C 的 入 门 知 识 。 


33.1 下 载 并 编 泽 |toa 


编译 Itoa 库 的 万 法 很 简单 ， 只 需要 人 在 合 令 行 运行 以 下 命令 : 


wget https://github.com/downloads/DmitrySkiba/itoa/build-ndk.sh 
chmod +X build-ndk.sh 
./build-ndk.sh 


上 述 脚 本 会 创建 一 个 名 为 itoa 的 文件 夹 ， 获 取 所 有 子 项 目 ， 并 企 itoa/ndk 目 录 中 构建 NDK。 最 终 的 文件 结构 如 图 33-1 所 
示 。 换 言 之， 该 脚本 首先 设置 工具 链 (tool chain) ， 然 后 以 此 编译 所 有 子 项 目 ， 最 终 会 在 /itoa/ndk/itoa/platform/arch- 
arm/usr/lib 文 件 夹 下 生成 .so 文件 。 


build-ndk.sh 
itoa 
ItoaApp.mk 
ItoaModule.mk 
cleancf 
foundation 
jnipp 
macemu 
main 
ndk 
objc 
toolchain 


























图 33-1 Itoa 文 件 结构 


33.2 ”划分 模块 


与 普通 NDK 应 用 程序 一 样 ， 我 们 会 把 代码 划分 到 不 同 模 块 中 。 我 们 会 创建 一 个 名 为 textformatter 的 模块 ， 该 模块 包含 需 
移植 的 代码 ; 此 外 ， 我 们 还 会 创建 男 一 个 名 为 main 的 模块 ， 用 于 负责 Java 代 码 与 TextFormatter 类 之 间 的 交互 。 


33.2.1 ”ltoaApp.mk 和 ltoaModule.mk 文 件 


与 Android NDK 使 用 Application.mk 和 Android.mk 等 make 文 件 类 似 ，ltoa 使 用 ltoaApp.mk 和 ItoaModule.mk 文 件 。 


在 Android 项 目 中 ， 我 们 需要 创建 一 个 名 为 jni 的 文件 夹 。jni 文 件 夹 中 包含 两 个 make 文 件 : ltoaApp.mk 和 
ltoaModule.mk。 此 外 ， 还 需要 在 jni 文 件 夹 中 创建 两 个 文件 夹 用 于 存放 不 同 模块 的 代码 ， 一 个 文件 夹 存放 textformatter 模 块 ， 
另 一 个 文件 夹 人 存放 main 模 块 。 在 每 个 模块 的 文件 夹 中 ， 还 需要 分 别 创建 一 个 ltoaModule.mk 文 件 。 最 终 的 目录 结构 如 图 33-2 所 


小 \。 


下 面 看 看 ltoaApp.mk 和 ltoaModule.mk 文 件 的 内 容 。 在 ltoaModule.mk 文 件 中 需要 措 定 jni 文 件 夹 下 各 个 模块 的 ltoa- 
Module.mk 文 件 ， 内 容 如 下 所 示 : 





ItoaApp.mk 
ItoaModule,.mk 
main 


[一 ItoaModule 
textformatter 
L— ItoaModule.mk 





图 33-2 jni 目 录 结 构 
THIS PATH := $(call my-dir) 


include S(THIS PATH)/main/ItoaModule.mk 
include S(THIS PATH)/TextFormatter/ItoaModule.mk 


ltoaApp.mk 文 件 中 的 内 容 更 有 趣 ， 内 容 如 下 : 


Q7 FEX 
APP IS LIBRARY :- true P 
APP LIBRARY BIN PATH = ../libs/s (TARGET APBI) Or 置 .so 文 
件 路 径 


使 用 ltoaApp.mk 文 件 的 默认 配置 对 于 我 们 当前 的 需求 已 经 足够 了 。 我 们 并 不 想 以 这 些 Objective-C 代 码 创建 Android 
APK， 因 此 需要 打开 库 模 式 @D。 第 2 条 配置 信息 用 于 设置 .so 文件 的 存放 路 径 @)。 


33.2.2 ”textformatter 模 块 


要 移植 的 库 很 简单 ， 该 库 只 包含 一 个 返回 NSString* 的 类 方法 。 该 库 的 Objective-C 代 码 由 a.h 和 a.m 两 个 文件 组 成 ， 源 码 如 
下 所 示 : 


#import <Foundation/Foundation.h> 


@interface TextFormatter: NSObject TextFormatter.h 文件 


+ (NSString *)format:(NSString *)text; 
@end 





#import "TextFormatter.h" 
TextFormatter.m file 文件 


aQimplementation TextFormatter 


+ (NSString *)format:(NSString *)text ( 
NSString *objc = QG"Text from Objective-c"; 


NSString *string [NSString stringWithFormat:Q8"$80 with %@", V 


objc, text]; A 


return string; TextFormatter.m file 文件 
} 


Qend 


读者 会 看 到 ， 不 需要 该 库 做 任何 改动 。 该 库 仪 仪 包 含 一 个 .h 文 件 和 一 个 .m 文 件 ， 这 两 个 文件 都 是 用 Objective-C 编 写 应 用 程 
序 时 常用 的 。 接 下 来 看 看 如 何 配 置 |toaModule.mk 文 件 来 编译 这 个 库 。 虽 然 |toa NDK 构 建 脚本 源 自 Android NDK， 但 是 已 经 被 
重 构 过 ,例如 ，ltoaModule.mk 会 把 所 有 LOCAL * 变 量 重 命名 为 MODULE *， 该 文件 的 内 容 如 下 所 示 : 


MODULE PATH := S$ (call my-dir) 
include S$(CLEAR, VARS) 


MODULE NAME := textformatter a HR 


MODULE SRC FILES := \ 
TextFormatter.m 4——— 要 编 详 的 源 文 件 


MODULE C INCLUDES += \ 
$ (MODULE PATH) \ a 头 文件 的 路 径 


include S(BUILD SHARED LIBRARY) 


是 不 是 与 Android NDK 的 make 文 件 很 相似 ? 
33.2.3 main 模块 


Main 模 块 中 有 两 个 源 文件 : 
“ JNIOnLoad.cpp: 在 该 文件 中 实现 JNI_OnLoad 方 法 


main.mm: 将 INI 调 用 和 TextFotmattef 实 现代 码 联 系 在 一 起 


首先 创建 JNIOnLoad.cpp 文 件 ， 源 码 如 下 所 示 : 


#include «CoreFoundation/CFRuntime.h» 
#include <jni.h> 


extern "C" 


{ 


jint JNI OnLoad(JavaVM *vm, void *reserved) { 
 CFInitialize(); a —— 4] 45, CoreFoundation 


extern void call dyld handlers(); a 加 载 Objective-C 类 
call dyld handlers(); 


return JNI VERSION 1. 6; 


加 载 native 库 上 时， 虚拟 机 会 调用 只 |_OnLoad 万 法 ， 因 此 该 万 法 是 初始 化 ltoa 的 好 地 方 。 接 下 来 实现 main.mm， 源 码 如 下 所 


A 


#include <jni.h> 

#import <Foundation/Foundation.h> 
#import <objc/runtime.h> 

#import <TextFormatter.h> 


extern "C" 

{ 

jstring 

Java, com manning androidhacks. hack033, TextFormatter formatString( 
JNIEnv* env, jobject thiz, jstring text) 


TextFormatter 
E 
jstring result = NULL; JNI JH 
NSAutoreleasePool *pool = [NSAutoreleasePool new]; 
const char *nativeText = env->GetStringUTFChars (text, 0); 
. : 将 jstring 转换 
NSString *objcText = JString TYX 
[NSString stringWithUTF8String:nativeText]; ð 为 NSString * 
env-»ReleaseStringUTFChars(text, nativeText); 
NSString *formattedText - [TextFormatter format: objcText]; 
result =  env-»NewStringUTF([formattedText UTF8String]); < 一 一 返回 结果 为 
[pool drain]; " 类 型 


return result; 
) 
) 


在 上 例 中 ， 我 们 在 一 个 源 文件 中 混用 了 C、C++ 和 Objective-C 人 代码。 从 方法 签名 可 以 看 出 TextFormatter 在 Java 层 的 
native 方 法 调用 传 入 的 参数 和 返回 值 都 是 String 类 型 @。 另 一 个 有 趣 的 地 方 是 ， 我 们 并 没有 在 TextFormatter 的 实现 方法 中 和 直接 
使 用 传 入 的 jstring 类 型 的 参数 ， 而 是 首先 把 该 参数 转换 为 char*， 然 后 册 转 换 为 NSString*@。 调 用 TextFormatter 的 实现 方法 
后 ， 我 们 会 得 到 一 个 NSString* 类 型 的 值 ， 需 要 将 该 值 转换 为 jstring 类 型 ， 要 完成 这 个 过 程 ， 首 先 需 要 将 其 转换 为 char*， 然 后 
调用 env 的 方法 创建 需要 返回 的 jstring@)。 


main 模 块 的 ltoaM odule.mk 文 件 如 下 所 示 : 


MODULE PATH := S$(call my-dir) 
include S (CLEAR VARS) 


MODULE NAME :- main a BA 
MODULE SRC FILES := \ 
JNIOnLoad.cpp \ " 要 编 详 的 源 文件 





main.mm AN 


MODULE C INCLUDES += V a4 BE TextFormatter.h 的 路 径 
S (MODULE. PATH)/../textformatter ^ 


MODULE SHARED LIBRARIES += textformatter dá AK textformatter JÆ 


include $(BUILD SHARED LIBRARY) 
APP SHARED LIBRARIES += $(TARGET ITOA LIBRARIES) -一 浴 加 Itoa.so 文件 


先 说 说 APP_SHARED _LIBRARIES 的 作用 Q@， 我 们 为 该 变量 指定 $ (TARGET ITOA LIBRARIES) 宏 ， 该 宏 表 示 
$1TOA_NDK/itoa/platform/arch-arm/usr/lib 目 录 下 的 .so 文件 会 被 包含 进 libs 目 录 。 如 果 查 看 上 述 目录 下 有 哪些 文件 ， 读 者 会 
发 现 里 面 的 .so 文件 远 多 于 我 们 的 实际 需要 。 因 此 ， 在 构建 项 目 之 前 ， 需 要 从 $ITOA _NDK/itoa/platform/arch-arm/usr/lib 目 录 
中 删除 (或 者 移 除 ) 以 下 库 : 


: libcg.so 
: libcore.so 
: libjnipp.so 


: libuikit.so 
33.2.4 ”编译 
bht, Anati eaa ES WLAB, dE OERSSEESRUEHTHHJ.soX EF, frjniBii& 3a 31A Püp s : 
SITOA NDK/itoa-build 


ITOA-BUILD-C 读 者 也 可 以 使 用 $ITOA NDK/itoa-build-C/path/to/jni 命 令 ， 该 命令 可 以 避免 切换 到 jni 文 件 夹 。 


编译 成 功 后 ， 我 们 就 会 得 到 所 有 在 Android 平 台 运行 Objective-C 代 码 所 必需 的 .so 文件 。 在 下 一 节 ， 我 们 会 看 到 如 何在 Java 
层 调用 这 些 库 。 


33.3 ”创建 Java 层 代码 


Java 层 包含 一 个 Activity 类 以 及 一 个 具有 native 方 法 的 TextFormatter 类 。Activity 类 的 源码 如 下 所 示 : 


public class MainActivity extends Activity ( 
private TextView mTextView; 


QGOverride 使 用 TextFor- 
public void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 


matter 的 for- 
matString J 
setContentView(R.layout.main); 法 为 TextView 
mTextView = (TextView) findViewById(R.id.text); 站 要 立木 内 突 

| mE ， 设置 文本 内 容 
String text = TextFormatter.formatString("Text from Java"); 
mTextView.setText(text); 


TextFormatter 的 Java 代 码 如 下 所 示 : 


public class TextFormatter { native J] 
public static native String formatString(String text); 用 声明 
static ( 

System.loadLibrary ("macemu"); EE JJE d FA Is BJ EE 


( 
System.loadLibrary("objc"); 
System.loadLibrary("cf"); 
System.loadLibrary("foundation"); 
System.loadLibrary("textformatter"); 
System.loadLibrary("main"); 


述 代码 中 最 重要 的 部 分 是 理解 static 代 码 块 中 的 库 是 如 何 加 载 的 四 。 要 加 载 的 库 如 下 所 示 : 
: Macemu: 包含 objc4 和 CoreFoundation 库 使 用 的 一 些 API 的 模拟 接口 
: Objc: objc4 运 行 时 
: cf: CoreFoundation % Æ 
: Foundation: Foundation/&- 
- Textformatter: 我 们 实现 的 TextFormatter 库 
Main: 我 们 实现 的 main 库 


运行 应 用 程序 后 ， 会 看 到 TextView 会 被 Java 和 Objective-C 两 个 世界 提供 的 渴 合 文本 所 填充 。 


33.4 概要 


使 用 ltoa 把 Objective-C 应 用 程序 移植 到 Android 或 许 是 一 个 好 主意 ， 但 具体 取决 于 需要 移植 的 代码 类 型 。 我 曾经 使 用 ltoa 
把 iOS 的 业务 多 辑 代码 移植 到 Android， 也 曾经 把 cocos2d-iphone 游 戏 移植 到 Android。 我 的 建议 是 ， 先 试用 一 秋 ， 然 后 再 决定 


|toa 是 否 适 用 于 你 的 项 目 。 


33.5 ”外 部 链接 


www.nasatrainedmonkeys.com/portfolio/shaman-doctor/ 
Wwww.cocos2d-iphone.org/ 

WWW.Cocos2d-x.org/ 

www.itoaproject.com/ 


https://github.com/DmitrySkiba/itoa-ndk/wiki/Variables 


Hack 34 在 Android 中 使 用 Scala 


Android v1.0 十 


Scala 是 一 种 多 泛 型 (multiparadigm) 的 编程 语言 ， 设 计 初 囊 是 要 集成 面向 对 象 编程 和 函数 式 编 程 的 各 种 特性 。 在 
Android 平 台 使 用 Scala 代 蔡 Java 创 建 项 目的 优点 主要 有 以 下 几 个 方面 : 


: 比 Java 更 简洁 
. 兼容 Java 人 代码 


: HE (closure) 


: 比 Java 更 易 处 理 线程 
讨论 Scala 相 比 Java 的 优点 已 经 超出 了 本 书 的 范畴 ， 但 是 我 们 可 以 看 看 Scala 都 提供 了 哪些 优 民 特性 。 在 这 个 Hack 里 ,我 会 


创建 一 个 具有 两 个 Activity 的 应 用 程序 ， 其 中 一 个 Activity 用 Java 语 言 编 写 ， 另 一 个 Activity 用 Scala 语 言 编写 。 这 是 一 个 理解 如 何 
编译 具有 Scala 代 码 的 Android 应 用 程序 的 基础 示例 。 


正如 读者 所 熟知 的 ， 构 建 Android 代 码 时 首先 会 把 Java 类 编译 为 字 节 码 ;， 然后 字 节 码 会 被 转化 为 dex 文 件 。 要 让 scala 代 码 运 
行 于 Android 平 台 ， 我 们 需要 具备 能 完成 下 述 操作 的 工具 : 


: 将 Scala 代 码 转 化 为 字 刷 码 

` 运行 Scala 标 准 库 以 缩减 应 用 程序 大 小 
处 理 Java 代 三 

- 创建 APK 


读者 可 能 不 会 相信 ， 完 成 上 述 操作 可 以 有 很 多 种 方式 。 从 我 个 人 的 观点 看 ， 最 好 的 万 式 是 安 滚 带 有 Android 插 件 的 SBT 工 


具 。 什 么 是 SBT? SBT 是 Simple Build Tool (简单 构建 工具 ) 的 缩写 ， 是 一 个 开源 的 Scala 构 建 工 具 ， 该 工具 的 优点 主要 体现 在 
以 下 几 个 方面 : 


: 项 目 结 构 与 Maven 类 似 
- 可 以 使 用 已 有 的 Maven 或 者 Ivy 仓 库 (repository) 管理 依赖 关系 
允许 混用 Scala 和 Java 人 代码 


那么 ，SBT 的 Android 插 件 提供 了 什么 功能 呢 ? 该 Android 插 件 是 一 个 脚本 ， 用 于 创建 SBT 可 以 编译 的 Android 项 目 。 此 外 ， 
该 插件 还 提供 了 为 Market 打 包 应 用 程序 以 及 向 设备 部 署 应 用 程序 等 便捷 的 功能 。 


如 果 读 者 使 用 BT 的 Android 插 件 创建 应 用 程序 ， 会 生成 与 图 34-1 相 似 的 项 目 结构 。 








project 
Build.scala 
plugins.sbt 
src 
main 
AndroidManifest.xml 
res 
layout 
L— main.xml 
values 
L— strings.xml 
scala 
L—— MainActivity.scala 
test 
[一 scala 
[一 Specs.scala 
tests 
src 
L— main 
— AndroidManifest.xml 
res 
[一 values 
L— strings.xml 
scala 


L— Tests.scala 


图 34-1 SBT Android4& £F Æ m, 8525 E 2544 


既然 SBT 也 支持 Java 代 码 ， 我 们 可 以 在 src/main/java 目 录 下 添加 Java 代 码 。 请 注意 ， 尽 管 Scala 语 言 不 要 求 根据 包 和 名 将 源 文 
件 划分 到 指定 的 文件 夹 中 ， 但 是 Java 语 言 有 这 样 的 要 求 。 在 这 个 Hack 里 ， 我 们 使 用 com.manning.androidhacks.hack034 作 为 
包 名 ， 因 此 我 们 需要 创建 遵循 这 个 目录 的 文件 结构 。 对 于 添加 一 个 Java 语 言 实现 的 Activity， 其 正确 的 项 目 结构 如 图 34-2 所 示 。 


project 
build.scala 
| plugins.sbt 
src 
main 
AndroidManifest.xml 
L— assets 


p 
— com 


L— manning 
[一 androidhacks 
L— hack634 
L— MainActivityJava.java 
= res 


layout 
L— main.xml 


values 

L— strings.xml 
scala 
L— ScalaActivity.scala 
test 
L— scala 
L— Specs.scala 





tests 
L—- src 
L— main 
—  AndroidManifest.xml 
res 
L— values 
L— strings.xml 
scala 
L— UnitTests.scala 














图 34-2 Java 代码 的 项 目 结 构 


先 来 看 看 Java 版 的 Activity， 然 后 再 分 析 其 如 何 与 Scala 版 的 Activity 交 互 ， 源 码 如 下 所 示 : 


public class MainActivityJava extends Activity { 


QOverride 

public void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


} 
局 动 Scala 版 
public void buttonClick(View v) { - " 
-- ! roi HJ Activity 
startActivity(new Intent (this, ScalaActivity.class)); 4 


) 


为 了 调用 Scala 版 的 Activity， 需 要 做 一 些 特别 操作 吗 ? 答案 是 “No”， 我 们 不 需要 任何 特别 操作 ， 只 需要 像 局 动 普通 
Activity 那 样 启动 Scala 版 的 Activity@)。 


现在 看 看 Scala 版 的 Activity 是 如 何 实现 的 ， 代 码 如 下 : 


class ScalaActivity extends Activity { 
. 产 $ 
override def onCreate(savedInstanceState: Bundle) { TextView 的 FÉ 
super.onCreate(savedInstanceState) 名 子 类 设置 为 


setContentView(new TextView(this) { <— ContentView 
setText("Activity coded in Scala ") 


)) 


可 以 看 到 ，Sscala 版 Activity 的 代码 100% 由 Scala 实 现 。 这 部 分 代码 来 自 于 SBT Android 插 件 创建 的 demo 应 用 程序 。 好 好 看 
看 ContentView 是 如 何 设置 的 四 ， 该 行 创 建 了 TextView 的 一 个 匿名 子 类 ， 然 后 通过 人 急 始 化 代码 块 调 用 了 setText () 方法 。 


要 运行 这 个 应 用 程序 ， 我 们 可 以 启动 SBT 然 后 执行 下 列 命令 : 
: android: package-debug 
* android: start-device 


不 足 之 处 是 创建 APK 的 过 程 比较 耗 时 。 编 译 这 个 双 Activity 的 应 用 程序 花费 了 我 大 约 1 分 钟 时 间 。 但 是 ， 这 不 是 Scala 本 身 的 
问题 ， 之 所 以 耗 时 很 久 是 因为 经 过 了 ProGuard 过 程 ， 该 过 程 遍历 Scala 库 ， 并 且 移 除 任何 无 用 部 分 。 为 了 解决 这 个 缺陷 ， 一 些 开 
友 者 将 Scala 库 添加 a 到 开发 设备 中 ， 甚 至 还 有 一 个 应 用 程序 可 以 将 Scala 安 六 在 已 经 root 过 的 设备 上 。 


34.1 概要 


Scala 在 Java 世 界 赢得 了 良好 的 发 展 势 头 ， 并 且 也 吸引 了 Android 开 发 者 社区 的 关注 。 学 习 一 门 新 的 编程 语言 是 比较 耗 时 
的 ， 但 是 scala 是 每 个 Java 开 发 者 都 应 该 党 试 使 用 的 编程 语言 。 


34.2 ”外 部 链接 


http://www.scala-lang.org/ 

http://en.wikipedia.org/wiki/Simple Build Tool 
https://github.com/jberkel/android-plugin 
http://nevercertain.com/2011/02/03/scala-android-intellij-win-part-1-prerequisites.html 


https://github.com/scala-android-libs/scala-android-libs 


第 9 草 ”可 复 用 的 代码 片段 


读者 经 常会 在 不 同 应 用 程序 中 使 用 相同 的 代码 吗 ? 如 果 是 ， 那 么 本 章 束 是 为 你 量 身 定做 的 。 本 草 ， 我 们 会 研读 一 些 代 码 片 
段 ， 读 者 可 以 简单 地 把 这 些 代码 片段 复制 /粘贴 到 任何 Android 应 用 程序 。 


Hack 35 同时 友 起 多 个 Intent 


Android v2.1 十 


Intent 系 统 是 Android 提 供 的 优秀 特性 之 一 。 如 果 开 上 友 者 想 与 另 一 个 应 用 程序 共享 信息 ， 融 可 以 使 用 Intent; 如 果 开 友 者 想 
打开 一 个 链接 ， 也 可 以 使 用 Intent。 在 Android 中 ， 几 乎 所 有 操作 都 可 以 通过 Intent 完 成 。 


如 果 读 者 使 用 过 移动 设备 上 的 即时 通讯 软件 WhatsApPp， 可 能 会 留意 到 其 中 一 项 功能 : 用 户 可 以 与 联系 人 分 享 图 片 ， 这 些 图 
片 既 可 以 位 于 相册 中 ， 也 可 以 即时 拍摄 。 提 示 用 户 从 相册 选择 一 张 图 片 或 者 担 摄 一 张 图 片 的 对 话 框 (Dialog) 如 图 35-1 所 示 。 
很 显然 ， 该 功能 是 通过 Intent 实 现 的 ， 但 是 ， 遗 憾 的 是 ， 开 上 友 者 无 法 只 用 一 个 Intent 实 现 。 











Choose an action 





图 35-1 ”选择 如 何 处 理 一 个 动作 的 对 话 框 


在 这 个 Hack 里 ， 我 会 分 析 如 何 实现 上 述 功能 。 稍 后 ， 读 者 不 但 会 看 到 拍摄 照片 的 Intent， 也 会 看 到 从 相册 中 选择 图 片 的 


Intent， 还 会 看 到 如 何 整合 这 两 个 Intent。 


35.1 担 照 


使 用 照相 机 应 用 程序 扣 报 照片 所 需 的 Intent 如 下 所 示 : 


Intent takePhotoIntent = new Intent(MediaStore.ACTION IMAGE CAPTURE); 

Intent chooserIntent - Intent.createChooser(takePhotoIntent, 
getString(R.string.activity main pick picture)); 

startActivityForResult(chooserlIntent, TAKE PICTURE); 


35.2 ”从 相册 中 选择 照片 


从 相册 应 用 程序 中 选择 照片 ， 需 要 使 用 如 下 Intent: 


Intent pickIntent - new Intent(Intent.ACTION GET CONTENT); 

picklIntent.setType("image/*"); 

Intent chooserIntent = Intent.createChooser(pickIntent, 
getString(R.string.activity main take picture)); 

sStartActivityForResult(chooserlIntent, PICK PICTURE); 


35.3 ”整合 两 种 Intent 


从 Android API level 5 开始 ， 开 发 者 可 以 创建 一 个 选择 式 Intent， 然 后 向 该 Intent 中 添加 额外 初始 化 Intent (Extra Initial 
Intent) ， 这 意味 着 不 必 局 限于 使 用 一 种 类 型 的 Intent， 开 友 者 还 可 以 同时 使 用 多 种 Intent。 使 用 方法 如 下 所 示 : 


Intent pickIntent = new Intent(Intent.ACTION GET CONTENT); -一 创建 选择 图 
pickIntent.setType("image/*"); Hr BS Intent 


Intent takePhotoIntent; 
> takePhotoIntent = new Intent(MediaStore.ACTION IMAGE CAPTURE); 


gl Æ 将 +ġ Hi 
2 BH Intent chooserIntent - Intent.createChooser (pickIntent, 将 OH ia 
H R getString(R.string.activity_main_pick_both)); Intent i i 
Intent chooserIntent.putExtra(Intent.EXTRA INITIAL INTENTS, + JJ Ai yh K 

new Intent [] {takePhotoIntent}); ^F. Intent 


startActivityForResult(chooserIntent, PICK OR TAKE PICTURE); 


上 述 代 码 会 把 处 理 两 种 Intent (拍照 或 选择 图 片 ) 的 所 有 应 用 程序 都 显示 出 来 。 不 要 忘记 ， 我 们 还 需要 在 当前 Activity 中 重 
写 (override) onActivityResult () 方法 ， 用 于 对 用 户 选 择 或 者 拍摄 的 图 片 做 出 处 理 。 


35.4 概要 


理解 Intent 的 原理 是 很 重要 的 。Intent 是 Android 的 核心 组 成 部 分 ， 正 确 使 用 Intent 可 以 使 应 用 程序 更 好 地 与 其 他 应 用 程序 
交互 。 例 如 ， 如 果 应 用 程序 中 使 用 了 本 例 所 示 的 代码 ， 并 且 设 备 中 还 有 一 个 文件 浏览 器 程序 ， 那 么 无 疑 ， 这 两 个 应 用 程序 可 以 产 
生 交 互 并 提供 更 好 的 用 户 体 验 。 


35.5 ”外 部 链接 


www.whatsapp.com/ 
http://stackoverflow.com/questions/11021021/how-to-make-an-intent-with-multiple-actions 


http://stackoverflow.com/questions/2708128/single-intent-to-let-user-take-picture-or-pick-image-from-gallery- 


in-android 


Hack 36 ”在 用 尸 反 人 馈 中 收集 信息 


Android v1.6+ 


天 注 用 户 反 馈 (feedback) 是 确保 应 用 程序 成 功 的 有 效 方式 乙 一 。 用 户 反 馈 可 以 突出 用 户 最 喜欢 应 用 程序 的 哪些 部 分 ， 用 
户 反 馈 还 可 能 要 求 开 发 一 些 新 特性 以 改进 应 用 程序 。 以 我 为 Android Market 开 发 应 用 程序 的 多 年 经 验 来 看 ， 我 发 现 ， 每 当 修复 
一 个 bug 或 者 添加 一 项 用 户 要 求 的 新 特性 后 ， 我 的 应 用 程序 会 被 更 多 人 下 载 。 这 里 ， 口 碑 起 到 了 关键 作 用 。 上 述 内容 提 供 了 一 个 
很 好 的 方案 一 一 虽然 很 多 时 候 ， 用 户 并 不 会 提供 足够 的 解释 ， 这 为 定位 问题 市 来 一 定 困难 ， 但 是 用 户 可 以 告知 开 友 者 他 们 遇 到 
了 什么 问题 。 


在 这 个 Hack 里 ， 我 会 向 读者 展示 如 何在 反馈 邮件 中 附加 用 户 设备 信息 。 这 意味 着 ， 从 用 户 获 取 一 些 重要 的 详细 信息 变 得 比 
较 简 单 了 ， 这 样 可 以 加 速 解 决 用 户 遇 到 的 问题 。 

读者 可 以 在 图 36-1 中 看 到 上 述 功能 的 最 终 效果 。 从 图 中 提供 的 信息 可 以 看 出 ， 用 户 运 行 的 应 用 程序 版 本 号 是 1.0， 运 行 的 设 
备 是 Nexus One， 所 处 的 位 置 是 阿根廷 ， 使 用 的 语言 是 英语 。 


E d u NN 


L'ompose 





NASA Traine 





d Monkeys «contac... ~ 


<feed@back.com>, 


[50 Android Hacks Feedback] 


Country: ar 

Brand: Android 

Model: Nexus One 

Device: passion 

Version: 1.0 (release 1) 
Locale: English (United States) 





图 36-1 反馈 邮件 


要 实现 上 述 功能 ， 需 要 创建 两 个 类 : 一 个 用 于 收集 用 尸 信息 ， 另 一 个 用 于 提供 发送 反馈 邮件 的 Intent。 先 分 析 
Environment-lnfoUtiljava， 源 码 如 下 所 示 : 


便于 获取 所 


public class EnvironmentInfoUtil ( 有 可 用 信息 
His 


public static String getApplicationInfo(Context context) { + 的 方法 


return String.format("£$sWMn$sWMn$sWMn$sMn$sWMn$sMn", 
getCountry(context), getBrandInfo(), getModelInfo(), 
getDeviceInfo(), getVersionInfo(context), 
getLocale(context)); 


使 用 Telephony- 


i Manager 确定 用 
public static String getCountry (Context context) { PREZ 
TelephonyManager mTelephonyMgr = (TelephonyManager) context 
.getSystemService(Context.TELEPHONY SERVICE); 
return String.format("Country: $s", mTelephonyMgr 
.getNetworkCountryIso()); 
) 从 Build 类 中 
public static String getModelInfo() ( < 十 获取 信息 


return String.format("Model: $s", Build.MODEL); 


使 用 Context 
获取 用 户 本 


public static String getLocale(Context context) ( < 地 化 信息 
return String.format("Locale: $s", context.getResources() Von 


.getConfiguration().locale.getDisplayName()); 


我 们 已 经 具备 了 负责 获取 用 户 信息 的 类 ， 但 是 如 何 通过 电子 邮件 友 送 这 些 信息 呢 ? 我 们 使 用 LaunchEmailUtil 类 完成 这 个 功 


CR 


public class LaunchEmailUtil ( 


> public static void launchEmailToIntent(Context context) { 
Intent msg - new Intent(Intent.ACTION SEND); 


StringBuilder body = new StringBuilder("MnMn---------- unt ys 
body.append(EnvironmentInfoUtil.getApplicationInfo(context)); 
从 Activit Ut 
n ed msg.putExtra(Intent.EXTRA, EMAIL, -O D ELI 
中 调用 该 J context.getString(R.string.mail support feedback to) 信 
法 RAR 
msg.putExtra(Intent.EXTRA SUBJECT, 
context.getString(R.string.mail support feedback subject)); 
msg.putExtra(Intent.EXTRA TEXT, body.toString()); «—— 使 用 Environ- 
, \ msg.setType("message/rfc822"); 
设置 选 g yp g ee 
PE 2& HJ context.startActivity(Intent.createChooser (msg, 提供 的 信息 设 
标题 > context.getString(R.string.pref sendemail title))); 置 邮 件 正 文 


我 们 可 以 在 一 个 Activity 中 调用 该 类 提供 的 launchEmail-Tolntent () 方法 @@。 该 方法 的 逻辑 比较 简单 : 在 strings.xml 文 件 
中 定义 向 谁 发 送 电子 邮件 @， 并 提供 邮件 正文 @。 为 了 防备 用 户 安 装 了 不 止 一 个 可 以 发 送 邮件 的 应 用 程序 ， 我 们 创建 一 个 应 用 程 
序 选择 器 并 为 该 选择 器 指定 自 定义 标题 @。 


36.1 概要 


FUERIS] FH se a c re LFBEEFRAUS IE RUIT A, ERRE: 在 准备 友 送 私人 信息 之 前 ,一 定 要 让 用 尸 知晓 。 


36.2 ”外 部 链接 


http://developer.android.com/reference/android/os/Build.html 


http://developer.android.com/reference/android/telephony/TelephonyManager.html 


Hack 37 ][5]media ContentProviderizJIIMP3 X44 


Android v1.6+ 


Android 用 户 都 知道 ， 如 果 想 在 设备 上 播放 一 首 音 乐 ， 只 需要 把 音乐 文件 拷贝 到 外 部 仓储 器 上 ( 通 单 是 一 张 SD 卡 ) 。 文 件 
拷贝 完成 后 ， 打 开 音 乐 播放 器 束 可 以 看 到 该 音乐 文件 。 这 是 怎么 实现 的 呢 ? 


在 Android 中 ， 提 供 了 一 个 名 为 ContentProvider 的 组 件 。ContentProvider 用 于 向 外 部 应 用 程序 提供 数据 。 例 
如 ，Android 中 有 一 个 与 联系 人 相关 的 ContentProvider， 这 意味 着 ， 在 设备 中 联系 人 应 用 程序 (Contacts) 提供 了 一 个 
ContentProvider 用 来 操作 联系 人 。 以 此 类 推 ， 读 者 还 可 以 找到 一 个 与 媒体 (media) 相关 的 ContentProvider。 


当 用 尸 向 外 部 存储 器 拷贝 媒体 文件 时 ， 有 一 个 进程 正在 浏 响 所 有 文件 夹 以 搜索 媒体 文件 ， 这 些 媒体 文件 会 被 添加 a 到 与 媒体 相 
关 的 ContentProvider 中 。 当 媒体 文件 被 添加 到 与 媒体 相关 的 ContentProvider 后 ， 所 有 应 用 程序 都 可 以 访问 该 文件 。 


假设 读者 正在 开 友 一 蒜 下 载 瘟 乐 的 应 用 程序 。 确 保 下 载 的 每 个 媒体 文件 都 能 被 添加 到 与 媒体 相关 的 ContentProvider 中 是 很 
重要 的 ,否则 ， 用 户 便 无 法 从 其 他 应 用 程序 中 访问 这 些 媒体 文件 。 


在 这 个 Hack 里 ， 我 们 会 分 析 将 MP3 文 件 添加 到 与 媒体 相关 的 ContentProvider 中 的 两 种 可 行 方法 。 在 示例 应 用 程序 的 
res/raw 文 件 夹 下 有 两 个 MP3 文 件 ， 我 们 会 把 这 两 个 文件 拷贝 到 外 部 仓储 器 中 。 拷 贝 成 功 后 ， 会 告诉 ContentProvider 添 加 了 新 
的 媒体 文件 。 


37.1 使 用 ContentValues) 东 加 MP3 文 件 


与 其 他 ContentProvider 一 样 ， 可 以 通过 ContentValues 添 加 新 的 元 素 。 代 码 如 下 所 示 : 


MediaUtils.saveRaw(this, R.raw.loopi1, LOOP1, PATH); 二 首先 将 文件 存 


ContentValues values = new ContentValues(5); 储 到 外 部 存储 
values.put(Media.ARTIST, "Android"); arp 
values.put(Media.ALBUM, "60AH"); < 完成 插入 媒体 文件 
values.put(Media.TITLE, "hack037"); | Bes a c EIL 

; i J. JJ -又 
values.put(Media.MIME TYPE, "audio/mp3"); riis INAFE 
values.put(Media.DATA, LOOP1_PATH); 通 过 URI 将 所 有 
getContentResolver().insert( < 值 搬 人 到 Content- 

Media.EXTERNAL CONTENT URI, values); Provider 中 


37.2 使 用 MediaScannern) 东 加 MP3 文 件 


上 一 小 节 中 提供 的 代码 可 以 正常 工作 ， 但 是 却 存在 一 个 很 大 的 问题 。 这 个 问题 在 于 需要 手动 设置 不 少 值 ， 如 果 能 从 媒体 文件 
中 获取 这 些 值 就 更 好 了 。 例 如 ，loop1.mp3 的 作者 是 “calpomatt” 而 非 "Android" ， 我 们 可 以 通过 读 取 MP3 文 件 的 元 数据 
(metadata) 获取 该 信息 。 


幸运 的 是 ， 有 一 种 方法 可 以 避免 手动 添加 这 些 值 。 源 码 如 下 所 示 : 


首先 将 文件 


TTR 
Uri uri = Uri.parse("file://" + LOOP2 PATH); 
Intent i - new Intent(Intent.ACTION MEDIA SCANNER SCAN FILE, 
sendBroadcastí1i); «1— 


发 送 广播 ， 请 求 扫描 并 
添加 指定 的 文件 


MediaUtils.saveRaw(this, R.raw.loop2, LOOP2 PATH); 


37.3 WE 


如 果 读 者 正在 开发 处 理 媒体 的 应 用 程序 ， 就 应 该 注意 与 媒体 相关 的 ContentProvider。 尝 试 深入 理解 并 正确 使 用 该 
ContentProvider， 这 对 用 户 来 说 是 至 关 重 要 的 。 


374 ”外 部 链接 


http://developer.android.com/guide/topics/providers/content-providers.html 
http://stackoverflow.com/questions/3735771/adding-mp3-to-the-contentresolver 


www.flashkit.com/loops/Pop-Rock/Rock/Get P-calpomat-4517/index.php 


www.flashkit.com/loops/Pop-Rock/Rock/ Hard-XtremeWe-6500/index.php 


Hack38 ”为 ActionBar 添 加 刷新 动作 


Android v2.1 十 


ActionBar 相 天 API 是 在 Android 3.0 版 本 (Honeycomb) 中 引入 的 。 引 入 ActionBar 组 件 的 目的 是 为 了 在 应 用 程序 界面 中 
提供 一 个 可 以 定位 用 户 的 “地 方 ”， 并 提供 与 上 下 文 相 天 的 动作 。 


读者 可 能 会 注意 到 一 些 应 用 程序 的 ActionBar 中 有 一 个 刷新 动作 。 用 尸 可 以 看 到 一 个 刷新 图 标 ， 点 击 该 图 标 后 ， 进 度 条 
(ProgressBar) 开始 旋转 ， 同 时 刷新 动作 开始 执行 。 遗 憾 的 是 ， 平 台中 并 没有 提供 这 样 一 个 UI 控件 一 一 开 友 者 需要 手动 创建 这 
种 控件 。 在 这 个 Hack 里 ,我 会 同 读者 展示 如 何 实现 该 控件 。 


为 了 保证 兼容 性 ， 我 们 使 用 Jake Wharton 开 发 的 ActionBar-Sherlock 共 享 库 。ActionBarSherlock 提 供 了 ActionBar 相 关 
API1， 但 是 却 可 以 用 于 较 早 版 本 的 Android。 


关于 ACTIONBARSHERLOCK 读 者 需要 知道 如 何 配 置 应 用 程序 以 使 用 ActionBarSherlock。 读 者 可 以 在 该 共享 库 的 官网 中 学 


习 这 部 分 内 容 ， 网 址 是 http://actionbarsherlock.com/。 


在 Activity 中 添加 ActionBar 的 第 一 步 是 : 让 应 用 程序 使 用 ActionBarSherlock 的 主题 (theme) 。 因 此 ， 需 要 在 Android- 
Manifest.xml 文 件 中 使 用 如 下 代码 : 


«application 
android:icon-"QGdrawable/ic launcher" 
android:label-"Gstring/app name" 
android:theme-"Gstyle/Theme.Sherlock"» 


第 二 步 是 创建 一 个 Activity， 该 Activity 不 能 继承 自 Activity 类 ， 而 是 继承 目 SherlockActivity。 在 ActionBar 中 显示 刷新 图 标 
的 代码 如 下 所 示 : 


public class MainActivity extends SherlockActivity { 
private static final int MENU REFRESH - 10; 
private MenuItem mRefreshMenu; 


QGOverride 创建 刷 
public boolean onCreateOptionsMenu(Menu menu) ( 新 菜单 


mRefreshMenu = menu.add(MENU REFRESH, MENU REFRESH, 

MENU REFRESH, "Refresh"); 
mRefreshMenu.setIcon(R.drawable.menu. reload); 
mRefreshMenu.setShowAsAction (MenuItem.SHOW AS ACTION ALWAYS); 


return true; 


运行 结果 如 图 38-1 所 示 : 


下 一 步 要 完成 的 功能 是 : 当 用 户 点 击 ActionBar 中 的 刷新 按钮 或 者 屏幕 中 央 的 按钮 时 应 该 如 何 处 理 。 要 处 理 上 述 两 种 操作 ， 
都 需要 局 动 后 台 任 务 。 为 了 模拟 后 人 台 任 务 ， 我 们 创建 一 个 AsyncTask， 源 码 如 下 所 示 : 


private class LoadingAsyncTask extends AsyncTask«Void, Void, Void» { 


QGOverride 
protected void onPreExecute() { TE Task HII 将 开 li 
super.onPreExecute(); | 
startLoading(); -| 时 处 理 UI 变化 
} 
@Override | 
protected Void doInBackground(Void... params) ( 休眠 5 pri 


SystemClock.sleep(5000L); q 
return null; 


} 


@Override " " 

protected void onPostExecute(Void result) ( 在 Task 即将 
super.onPostExecute(result); 结束 时 处 再 
stopLoading(); < UI 变化 


} 


A E" 
e miz[e 481. 








图 38-1 基本 的 ActionBar 


在 单独 一 个 方法 中 局 动 并 执行 AsyncTask: 


public void handleRefresh(View v) ( 
new LoadingAsyncTask().execute(); 


在 Activity 布 局 文件 中 将 屏幕 中 央 按 钮 的 android: onClick 属 性 指定 为 handleRefresh， 这 样 当 点 击 该 按 钮 和 时， 上 述 方法 就 
会 收 调 用 。 此 外 ， 当 操作 ActionBar 时 ，onOptionsltemSelected () 万 法 被 触 友 ， 进 而 也 会 调用 handleRefresh 方 法 。 


就 快 大 功 告 成 了 。 这 里 唯一 缺少 的 是 当 后 台 任 务 启动 和 结束 时 如 何 处 理 Ul 变 化 的 代码 。 对 于 屏幕 中 央 的 按钮 ， 处 理 逻 辑 比 
较 简 单 : 当 后 人 台 任 务 运行 时 ， 将 该 按钮 置 为 不 可 用 ; 反之 ， 当 后 台 任 务 完成 时 ， 将 其 置 为 可 用 。 可 以 使 用 
setEnabled (Boolean enabled) 方法 实现 上 述 功能 。 现 在 最 大 的 问题 是 如 何 用 某 种 可 旋转 的 视图 代 蔡 进度 菜单 项 ， 为 了 解决 
这 个 问题 ， 我 们 使 用 ActionView。 


开发 文档 ( 见 38.2 节 ) 中 对 ActionView 的 解释 如 下 所 示 : 


ActionView 是 在 ActionBar 中 显示 的 一 种 控件 ， 用 于 替代 一 个 动作 项 按钮 。 例 如 ， 如 果 在 选项 菜单 中 有 一 个 搜索 项 ， 开 发 者 可 
以 添加 一 个 ActionView， 然 后 使 用 SeatchView 控 件 替 代 该 搜索 项 ， 如 图 38-2 所 示 。 





= 画 画 


Searchable Dictionary Q 





|Q, Search the dictionary 





图 38-2 EUH ActionViewügActionBar, AP, Jp 'Action-ViewJf] FR & (上 ) ， 展 开 的 ActionView 用 于 显示 SeatchView 控 件 


(CTF) 


因为 需要 通过 ActionView 添 加 一 个 旋转 控件 ， 所 以 我 们 通过 XML 文件 为 其 创建 视图 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
style-"?attr/actionButtonStyle" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:addStatesFromChildren-"true" 
android:focusable-"true" 
android:gravity-"center" 
android:paddingLeft-"A4dp" 
android:paddingRight-"4dp" > 


«ProgressBar 
android:layout width-"30dp" 
android:layout height-z"30dp" 
android:focusable-"true" /> 


«/LinearLayout-» 


既然 有 了 XML 文件 ， 剩 下 的 内 容 就 很 简单 了 。startLoading () 和 stopLoading () 方法 处 理 刷 新 菜单 项 的 ActionView 的 
代码 如 下 所 示 : 


private void startLoading() ( 
mRefreshMenu.setActionView(R.layout.menu item refresh); 
mButton.setEnabled(false); 


private void stopLoading() ( 
mRefreshMenu.setActionView (null); 
mButton.setEnabled(true); 


在 这 个 Hack 里 ， 我 们 举例 说 明了 如 何 自 定 义 ActionBar 的 条 目 。 目 前 ， 几 乎 每 个 应 用 程序 都 会 使 用 ActionBar。 为 此 ， 十 分 
感谢 Jake Wharton， 他 为 开发 者 提供 了 一 套 Android 共 享 库 ， 让 开发 者 能 够 在 旧版 本 中 使 用 ActionBar。 知 道 该 库 能 够 做 什么 以 
及 理解 该 库 如 何 满足 应 用 程序 需求 是 很 重要 的 。 


38.2. Mine 


http://developer.android.com/guide/topics/ui/actionbar.html 


http://actionbarsherlock.com/ 
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在 Android 中 ， 一 个 应 用 程序 依赖 于 其 他 应 用 程序 完成 任务 的 情况 是 很 普遍 的 。 得 葵 于 Android 的 Intent 系 统 ， 开 友 者 可 以 
请 求 其 他 应 用 程序 来 完成 一 个 任务 。 例 如 ， 开 友 者 通常 不 会 为 应 用 程序 添加 照相 机 提 照 的 逻辑 ， 而 是 请 求 照相 机 应 用 程序 为 其 完 
成 担 照 任务 ， 并 返回 结果 。 正 因为 可 以 创建 一 个 应 用 程序 ， 通 过 传递 Intent 调 用 来 提供 功能 ， 所 以 应 用 程序 可 以 信 助 于 Market 
上 很 多 其 他 应 用 程序 提供 的 功能 。 


在 这 个 Hack 里 ， 读 者 会 看 到 企 试图 上 友 起 一 个 Intent 调 用 前 ， 如 何 检查 系统 中 是 否 已 经 安 半 了 有 某 个 应 用 程序 。 如 果 该 应 用 程 
序 未 安装 ， 会 请 求 用 户 从 Market 上 下 载 该 应 用 程序 。 对 于 本 例 ， 我 们 会 使 用 名 为 Layar 的 应 用 程序 。Layar 是 一 款 手 机 浏览 器 软 
件 ， 该 软件 基于 现实 感 增强 技术 (augmented reality technology) ， 人 允许 用 户 查找 各 种 信息 。 开 发 者 可 以 创建 一 种 称 为 图 层 
的 东西 (layer) ， 该 图 层 用 于 在 Layar 浏 览 器 中 显示 关注 点 。 我 们 会 创建 一 个 普通 应 用 程序 ， 该 应 用 程序 有 一 个 指向 Layar 中 某 
个 图 层 的 链接 。 要 创建 该 应 用 程序 ， 需 要 完成 如 下 功能 : 


. 判断 是 否 安 装 了 Layat 的 方法 
- 编写 代码 以 打开 Market 下 载 Layar 
打开 一 个 特定 图 层 的 Intent 调 用 


判断 是 否 安装 了 Layar， 可 以 使 用 PackageManager 类 ， 代 码 如 下 所 示 : 


public static boolean isLayarAvailable(Context ctx) ( 
PackageManager pm = ctx.getPackageManager(); 


PackageManager 

try ( 

HJ getApplication- 
pm.getApplicationInfo("com.layar", 0); Info() 方法 
return true; 

| 表示 无 法 获取 
) catch (PackageManager.NameNotFoundException e) { 


应 用 程序 信息 


return false; < 


判断 某 个 应 用 程序 是 否 可 用 的 最 简单 方法 是 使 用 Package-Manager 提 供 的 getApplicationlnfo () 方法 ， 该 方法 需要 用 到 
应 用 程序 的 包 名 。 如 果 应 用 程序 存在 ， 该 方法 会 返回 一 个 Applicationlnfo 对 象 ， 并 且 以 AndroidManifest.xml 的 <application> 
标签 中 的 内 容 填充 该 对 象 。 如 果 在 试图 获取 应 用 程序 信息 的 过 程 中 得 到 一 个 NameNotFoundException 异 常 ， 开 发 者 就 可 以 确 
定 该 应 用 程序 不 可 用 。 


现在 ， 运 行 打开 Market 的 代码 : 


public static AlertDialog showDownloadDialog(final Context ctx) ( 


AlertDialog.Builder downloadDialog = new AlertDialog.Builder(ctx); 
downloadDialog.setTitle("Layar is not available"); < 一 一 创建 一 个 
downloadDialog AlertDialog, 

.SetMessage("Do you want to download it from the market?"); 


M y pum 
downloadDialog.setPositiveButton("Yes", 让 用 户 决定 
ickLi 是 否 需要 从 

new DialogInterface.OnClickListener() { AE mu - 
Market 上 下 


GOverride N 
public void onClick(DialogInterface dialogInterface, int i) { 载 Layar 





要 启动 M piis Uri uri = Uri.parse("market://details?id-com.layar"); 
nica = Intent intent = new Intent(Intent.ACTION VIEW, uri); 
ket， 可 以 使 try ( 
Hj URI Jf ctx.startActivity(intent); 一 此 Android 
指 ^E Intent ) catch VCELVACYNOEEOURGEXCSD UEM €] ( 设备 上 可 能 并 
的 ti p, Toast.makeText(ctx, "Market not installed", 没有 M ket 应 
* ! 
kn Toast.LENGTH, SHORT) . show() ; P ME 
ACTION VIEW ) 用 程序 ， 这 里 
) 使 用 try-catch 
块 确保 应 用 程 
| | HER Hi 
downloadDialog.setNegativeButton("No", 
new DialogInterface.OnClickListener() ( 
QGOverride 


public void onClick(DialogInterface dialogInterface, int i) ( 
) 
3) & Æ AlertDialog 
Jg. 就 可 以 显示 
return downloadDialog.show(); <q 由 来 了 


最 后 一 步 是 要 添加 代码 逻辑 用 于 判断 是 人 否 应 该 下 载 Layar 或 者 通过 Intent 启 动 一 个 图 层 天 注 点 。 下 面 是 点 击 某 个 按钮 后 的 执 
行 逻 辑 : 


public void onLayarClick(View v) { 


if ( !ActivityHelper.isLayarAvailable(this) ) { 显示 下 载 对 
LI- HC r1 
ActivityHelper.showDownloadDialog(this); < WEHE 1537 3H 
) else ( 
Intent intent - new Intent(); «un 果 Layar 
intent.setAction(Intent.ACTION VIEW); | ERN 
` ` em ; " å - mes " . 可 il * 1H 过 
Uri uri = Uri.parse("layar://teather/?action-refresh"); 
intent.setData(uri); 其 URI 显示 
startActivi ty(intent) 7 teather [| EZ 
} 
} 
39.1 概要 


很 多 应 用 程序 都 可 以 提供 这 种 类 型 的 Intent API。 使 用 这 种 API 有 两 个 重要 优势 。 第 一 个 优势 很 明显 : 编码 更 少 。 第 二 个 优 
势 是 : 如 果 用 尸 已 经 在 使 用 某 个 同类 应 用 程序 ， 那 么 ， 这 意味 着 用 户 不 必 再 学习 完成 某 个 操作 的 另 一 种 方法 。 例 如， 如 果 希 望 应 
用 程序 可 以 抓 取 快照 ， 开 上 友 者 不 必 提 供 一 种 新 的 方法 ， 只 需要 使 用 担 照 应 用 程序 目 身 的 功能 ， 而 这 项 功能 正 是 用 尸 所 熟知 的 。 


39.2 ”外 部 链接 


http://layar.com/ 
http://developer.android.com/reference/android/content/pm/PackageManager.html 


http://developer.android.com/reference/android/app/AlertDialog.html 
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开发 者 经 常 面 对 的 一 个 挑战 是 显示 网 络 上 的 图 片 。 这 个 挑战 会 以 不 同 的 形式 出 现 ， 例 如 在 列表 中 显示 很 多 图 片 。 这 类 挑战 的 
理想 解决 万 案 需 要 包括 以 下 几 个 方面 : 


保持 响应 灵敏 的 UI 


: 在 应 用 程序 UI 线程 之 外 处 理 网 络 和 磁盘 I/ 〇 操作 
- 对 于 ListView， 需 要 支持 视图 回收 
` 快速 显示 图 片 的 缓存 机 制 


解决 这 个 难题 的 许多 万 案 是 使 用 内 存 缓存 来 保存 之 前 加 载 的 图 片 ， 并 且 通 过 一 个 线程 池 为 需要 加 载 的 图 片 排队 。 但 是 一 个 经 
党 被 忽 略 的 特性 是 图 片 被 请 求 加载 的 顺序 。 


考虑 ListView 中 每 行 都 包含 一 个 图 片 的 情况 。 如 果 用 尸 同 下 滚动 (fling) 列表 ， 多 数 图 片 加 载 万 案 会 根据 图 片 所 在 的 父 视图 
显示 a 到 屏幕 的 顺序 来 加 载 每 张 图 片 。 结 果 是 ， 当 用 户 停 止 滚动 操作 ， 当 前 显示 在 屏幕 上 的 行 ， 虽然 是 当前 时 点 最 重要 的 行 ， 但 是 
却 会 被 冲 后 加 载 。 开 友 者 想 要 的 效果 是 最 后 请 求 显示 的 行 能 够 通过 “插队 ”被 优先 处 理 。 


40.1 起点: Android 示 例 程 序 


Android 官 方 文档 的 培训 章节 (Training) 包含 一 篇 名 为 “高 效 显示 Bitmap” 的 文档 (4140.615) ， 我 们 融 以 该 文档 为 起 
点 。 该 文档 涵盖 了 多 个 核心 概念 ， 比 如 将 图 片 缩减 采样 (downsampling) 到 合适 大 小 、 使 用 LruCache 类 实现 内 存 缓存 (在 
Support Library, version 4 中 可 用 ) 以 及 在 UI 线程 外 执行 工作 的 基本 机 制 。 


我 们 会 扩展 这 个 示例 程序 以 达到 优先 加 载 最 近 请 求 图 片 的 目的 。 此 外 ， 还 会 对 原始 版 本 做 一 些 性 能 优化 ， 优 化 方法 是 移 除 应 
用 程序 适配器 (adapter) 每 次 调用 getView () 方法 时 都 会 创建 一 个 AsyncTask 实 例 的 错误 用 法 。 当 向 上 或 向 下 浴 动 多 次 后 ， 
示例 程序 有 可 能 友 生 运行 时 异常 ， 导 致 RejectedExecutionException， 该 异常 是 由 过 多 的 AsyncTask 实 例 引 起 的 。 在 最 后 的 例 
子 中 ， 我 们 会 解决 这 个 问题 。 


40.2 引入 executor 


使 用 AsyncTask 的 解决 方案 并 不 适用 于 处 理 大 量 图 片 ， 也 不 会 让 开 友 者 控制 任务 的 优先 级 。 作 为 蔡 代 方案 ， 我 们 使 用 
java.util.concurrent 包 中 的 执行 器 服务 (executor service) 和 一 个 优先 级 队列 来 指定 请 求 图 片 的 顺序 。 在 新 的 实现 方案 中 ， 可 
以 提供 与 AsyncTask 相 似 的 万 法 ， 即 ， 当 某 个 任务 不 需要 向 屏幕 显示 信息 时 ， 便 取消 该 任务 。 后 进 先 出 (LIFO) 实现 方案 包含 
两 个 类 : LIFOTask 和 LIFOThreadPoolProcessor。 


新 的 任务 对 象 会 提供 一 个 静态 变量 counter 用 于 表示 创建 的 实例 数量 。 因 为 新 创建 任务 的 counter 一 定 更 大 ， 所 以 该 变量 可 
以 起 到 标识 任务 优先 级 的 作用 。 我 们 利用 counter 实 现 compareTo () 万 法 用 于 排序 : 


public class LIFOTask extends FutureTask«Object-» 
implements Comparable«LIFOTask» ( 


private static long counter = 0; 


private final long priority; 


public LIFOTask(Runnable runnable) ( 


super(runnable, new Object()); 

priority = counter--*; x 本 例 的 任务 都 
是 在 相同 线程 
中 创建 的 


public long getPriority() ( 


return priority; 


) 


QOverride 
public int compareTo(LIFOTask other) { 


return priority > other.getPriority() ? -1 : 1; 


此 时 ， 基 类 的 选择 非常 重要 ， 我 们 选择 继承 上 自 FutureTask 类 ， 访 类 会 被 传 入 Executor 类 ， 因 为 它 暴露 了 一 个 取消 方法 , 与 
使 用 AsyncTask 的 旧 实 现 非 昔 相 似 。 


创建 了 LIFOTask 类 ， 需 要 在 ThreaPoolExecutor 类 中 使 用 其 compareTo () 方法 : 


public class LIFOThreadPoolProcessor { 
private BlockingQueue«cRunnable» opsToRun = 
new PriorityBlockingQueue«Runnable»(64, new Comparator«Runnable»() { 
aOverride 
public int compare (Runnable r0, Runnable r1) { 


if (r0 instanceof LIFOTask && rl instanceof LIFOTask) ( 
LIFOTask 10 = (LIFOTask)rO0; 
LIFOTask 11 = (LIFOTask)r1i1; 
return lO.compareTo(11); 


) 


return O0; 
} 
)); 


private ThreadPoolExecutor executor; 


public LIFOThreadPoolProcessor(int threadCount) ( 
executor = new ThreadPoolExecutor(threadCount, threadCount, 0, 
TimeUnit.SECONDS, opsToRun); 
) 


public Future<?> submitTask(LIFOTask task) ( 
return executor.submit(task); 


) 


public void clear() { 
executor.purge(); 


iZ2érnzSEEMEEHJSBA mÍ&AThreadPoolExecutorf4i&757EBg2 2, 3364i 1 E89 Fo] AETR BAIA, HEHA 
PriorityBlockingQueue 作 为 客户 端 应 用 程序 所 提交 任务 的 容器 。 然 后 ， 我 们 使 用 LIFOTask 对 象 的 compareTo () 方法 得 到 期 
望 的 优先 级 顺序 。 注 意 ， 在 本 例 中 ，keepAlive 时 间 参 数 不 适 用 于 给 定 的 核心 线程 池 大 小 和 最 大 线程 池 大 小 。 


40.3 ”UI 线程 一 一 离开 返回 的 无 颖 衙 接 


作为 Android 开 发 者 ,我们 都 知道 保持 UI 响应 灵敏 的 重要 性 ， 因 此 开发 者 把 类 似 Il/O 操 作 这 样 的 耗 时 任务 放 在 后 台 线 程 中 执 
行 。 当 后 台 线 程 执行 完毕 后 ， 经 常 需要 更 新 UJIl。Android 可 能 与 读者 熟知 的 其 他 UI 系统 非常 相似 ， 并 不 是 线程 安全 的 。 在 修改 任 
何 lImageView 之 前 ,必须 返回 到 应 用 程序 主线 程 中 ， 试 图 在 主线 程 之 外 修改 UI 会 导致 异 帅 。 


台 实 现代 码 使 用 的 是 AsyncTask 的 onPostExecute () 方法 。 因 为 我 们 使 用 Executor 代 替 AsyncTask， 因 此 需要 为 宿主 
Activity 准 备 一 个 Runnable 对 象 。 我 们 会 用 到 Activity 的 runOnUiThread () 方法 ， 访 方法 会 使 用 Handler 在 后 台 将 我 们 的 工作 
添加 a 到 UI 的 消息 队列 中 。 


切换 到 UI 线程 是 需要 考虑 的 。 读 者 必须 注意 下 述 几 个 方面 : 
如 果 用 户 滚动 ListView，lLmageView 的 实例 有 可 能 被 回收 


宿主 Activity 有 可 能 在 任务 完成 前 已 经 被 销毁 


因此 ， 用 于 处 理 图 片 的 Runnable 的 每 一 步 都 需要 检查 是 否 应 该 停止 处 理 图 片 。 如 果 宿 主 Activity 使 用 lImageWorker 的 
setExit-TasksEarly () 方法 设置 一 个 标记 (flag) ， 就 可 以 检查 到 停止 状态 ， 该 方法 需要 在 onPause () 方法 中 调用 。 此 外 ， 
如 果 FutureTask 的 cancel () 方法 被 调用 ， 也 可 以 检查 到 停止 状态 。 


40.4 ”注意 事项 


对 于 产品 级 应 用 程序 ，Android 官 方 文档 的 training 小 书 建议 使 用 更 好 的 磁盘 缓存 解决 方案 。 原 始 文 档 提供 的 实现 方案 缺少 
几 个 关键 部 分 ， 为 此 ， 这 里 提供 一 个 更 完整 的 例子 ， 修 改 磁盘 缓存 的 实现 代码 ， 使 其 支持 在 应 用 程序 重启 时 可 以 重建 磁盘 缓存 ， 
并 且 不 再 需要 维护 这 部 分 代码 的 两 份 拷贝 。 


40.5 ”概要 
加 载 图 片 等 耗 时 工作 需要 在 Ul 线程 之 外 执行 ， 这 会 使 类 似 ListView 这 样 的 内 置 组 件 平滑 运行 。 读 者 可 以 使 用 一 个 LIFO 队 列 
对 加 载 图 片 的 顺序 进行 微调 ， 以 此 获得 更 好 的 用 尸体 验 。 


使 用 一 个 可 能 会 生成 无 数 实例 的 AsyncTask 会 导致 潜在 问题 。 使 用 executor 可 以 更 好 地 完成 AsyncTask 的 工作 。 此 
外 ，Android 在 支持 库 中 提供 了 一 个 稳定 的 LruCache 实 现 ， 用 于 提供 高 效 缓存 解决 方案 。 


40.6 “外 部 链接 


http://developer.android.com/training/displaying-bitmaps/index.html 
http://developer.android.com/tools/extras/support-library.htmlzzUsing 
http:;//developer.android.com/reference/java/util/concurrent/ExecutorService.html 


http:;//developer.android.com/reference/java/util/concurrent/FutureTask.html 


B10 ”数据库 进 阶 


如 果 读 者 开发 过 Android 应 用 程序 ， 丈 可 能 用 到 | 数据库 来 持久 化 数据 信息 。 本 草 ， 我 会 为 熟练 使 用 Android 数 据 库 的 开 友 者 
提供 一 些 高 级 技 15。 
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Android 应 用 程序 通常 会 面临 各 种 形式 的 持久 化 存储 需求 ， 这 意味 着 用 户 在 每 次 启动 应 用 程序 之 间 都 可 能 需要 保存 一 些 数 
据 。 为 了 满足 上 述 需 求 ，Android 使 用 了 关系 型 数据 库 SQLite。 本 Hack 使 用 ORMLite 工 具 创 建 一 个 完整 的 数据 库 示 例 。 
ORMLite 是 一 种 对 象 关系 映射 (Object-Relational Mapping, fSERORM) 工具 ， 也 可 用 于 读 写 数据 。 


我 们 的 最 终 目的 是 创建 一 个 可 以 分 类 显示 文章 ， 并 且 人 允许 用 户 评论 每 篇 文章 的 应 用 程序 。 该 应 用 程序 的 最 终 效果 如 图 41-1 
所 示 。 


应 用 程序 中 所 有 数据 库 操作 都 通过 ORMLite 完 成 ， 而 不 需要 手工 编写 任何 SQL 语 句 。 该 方法 可 以 通过 减少 创建 数据 库 
schema 的 代码 数量 来 节省 时 间 。 


P 
OrmLiteDem 


Loaded from SQLite using 
OrmLite 


Article 0 


Created on 9/15/2012 9:14 AM 


Created on 9/15/2012 9:14 AM 





Created on B EFVUOBFRUSEE! 


Article 3 


created on S1595/2012 9:14 AM 


Arücle 4 


Created on 915/2012 9:14 AM 





图 41-1 应 用 程序 最 终 效果 


最 终结 果 会 显示 一 个 分 类 (Category) 和 子 分 类 的 列表 以 及 文章 标题 。 用 户 点 击 一 篇 文章 后 ， 会 切换 到 一 个 新 的 Activity 
中 ， 在 该 Activity 中 显示 文章 的 详细 信息 并 且 人 允许 用 户 友 表 对 该 文章 的 评论 (Comment) 。 应 用 程序 会 使 用 如 图 41-2 所 示 的 数 
据 模 型 。 


图 41-2 摘 述 了 一 个 允许 有 以 下 内 容 的 数据 库 : 


: 具备 ID 和 标题 的 分 类 (Categoty) 。 一 个 分 类 也 可 以 有 一 个 父 分 类 ， 但 是 父 分 类 不 是 必需 的 ， 因 为 最 上 层 的 分 类 是 没有 父 


分 类 的 。 
. 具备 ID、 标 题 、 正 文 内 容 以 及 创建 时 间 的 文章 (Article) 。 
- 具备 ID、 姓 名 和 电子 邮件 地 址 的 作者 (Author) 。 
. 文章 可 以 属于 多 个 不 同 分 类 ， 分 类 可 以 包含 多 篇 文章 。 
` 文章 可 以 由 多 个 作者 完成 ， 作 者 也 可 以 完成 多 篇 文章 
: 一 条 评论 (Comment) 对 应 一 篇 特定 的 文章 并 包含 ID、 添 加 评论 的 用 户 名 、 评 论文 本 、 评 论 发 表 日 期 等 信息 


一 篇 文章 可 以 有 多 条 评论 。 








图 41-2 ”数据 模型 


当 设 计 需 要 使 用 关系 型 数据 库 的 应 用 程序 时 ， 首 先 从 类 似 本 例 的 数据 模型 图 入 手 是 相当 有 用 的 。 本 例 的 数据 模型 图 称 为 实 
体 -天 系 图 (entity-relationship diagram，ER 图 ) 。ER 图 是 在 开 友 过 程 的 设计 阶段 使 用 的 ， 用 于 识别 不 同 的 实体 以 及 实体 间 的 
天 系 。 


41.2 ”开始 


使 用 ORMLite 时 ， 需 要 用 到 其 release 版 本 中 的 两 个 JAR 包 : core 和 android。 本 例 的 应 用 程序 使 用 的 是 4.41 版 。 获 取 依 赖 包 
， 束 可 以 开始 创建 数据 库 schema 了 。 


ll 


使 用 ORM Lite 的 第 一 步 是 实现 应 用 程序 中 需要 操作 的 Java 实 体 类 。 在 该 过 程 中 ， 读 者 需要 特别 注意 ， 在 类 中 包含 注解 


(Annotation) 以 允许 ORMLite 创 建 所 需 的 数据 库 表 。 在 有 复杂 数据 库 关系 的 情况 下 ， 当 从 对 象 中 访问 数据 库 时 ， 这 些 注解 还 
可 以 为 DRMLite 提 供 如 何 操作 的 信息 。 ， 使 用 注解 的 万 法 只 是 指定 ORM Lite 所 生成 的 数据 库 schema 的 多 种 方式 中 的 一 种 。 


使 用 ORMLite 时 最 常用 的 两 种 注解 是 DatabaseTable 和 DatabaseField。 这 些 注解 可 以 分 别 用 于 类 及 其 成 员 变 量 ， 并 允许 生 
成 最 终 的 数据 库 表 。 使 用 注解 的 Article 类 的 简单 实现 如 下 所 示 : 


@DatabaseTable 

public class Article { 
@DatabaseField(generatedId = true) 
puDLië Ant 10> 


@DatabaseField 
public String title, text; 





@DatabaseField ORMLite 2; 要 
public Date publishedDate; Ek. s 
用 到 无 参 构造 
public Article() { «— 方法 
} 


-— 


该 类 ， 只 是 全 部 实现 代码 的 一 部 分 ， 会 生成 如 下 创建 表 的 SQL 语句 : 


CREATE TABLE 'article' 
('title' VARCHAR, 'publishedDate' VARCHAR, 'text' VARCHAR, 
'id' INTEGER PRIMARY KEY AUTOINCREMENT); 


注意 id 字段 对 应 的 注解 。 对 于 该 注解 ， 我 们 指定 了 generatedld=true 参 数 ， 该 参数 表示 该 字段 是 主键 (primary key) , 3f 
且 由 SQLite 数 据 库 自动 指定 。 另 外 还 要 注意 ， 默 认 情 况 下 ，ORMLite 使 用 类 名 作为 SQL 表 名 ， 使 用 成 员 变 量 名 作为 表 的 列 名 。 


最 后 ， 读 者 可 以 注意 到 ORM Lite 需 要 类 中 提供 一 个 无 参 构造 方法 。 当 ORMLite 需 要 创建 Article 类 的 实例 时 ， 比 如 在 查询 并 
返回 文章 列表 的 情况 下 ，ORMLite 会 使 用 无 参 构造 方法 ， 并 通过 反射 机 制 设 置 成 员 变 量 (ORMLite 也 可 以 使 用 setter 方 法 设置 成 


员 变 量 ) 。 


41.3 ” 坚 如 磐石 的 数据 库 schema 


基于 第 一 个 从 Java 类 生成 数据 库 表 的 最 简单 的 例子 ， 我 会 演示 下 述 内 容 
| 自 定义 数据 库 表 和 表 列 的 名 字 

` 处 理 类 之 间 的 关系 

: 关系 的 参照 完整 性 (API Level 8 及 以 上 ) 


- RAMA (API Level 8 及 以 上 ) 


交叉 引用 的 唯一 性 约 来 


真实 世界 中 ， 大 多 数 数 据 库 实例 会 用 到 上 述 这 些 概念 以 及 一 些 其 他 概念 。 即 便 通 过 ORM 工具 来 构建 数据 库 表 ， 依 然 需要 具 
备 建立 可 靠 的 数据 库 schema 以 加 强 数 据 一 致 性 的 表达 能 力 。 例 如 ， 我 们 可 能 要 求 文章 的 标题 和 正文 内 容 不 能 为 空 。 我 们 还 可 以 
确保 一 个 分 类 是 否 有 父 分 类 以 及 父 分 类 是 否 实际 仔 人 在。 此外， 我 们 可 以 指定 如 果 一 篇 文章 局 删除 ， 与 其 天 联 的 所 有 评论 以 及 该 广 
草 与 其 分 类 的 映射 关系 是 否 会 被 SQLite 目 动 删除 。 


当 定 义 schema 时 ， 第 一 个 建议 便 是 使 用 final 变 量 定义 数据 库 表 名 和 列 名 。 实 路 中， 当成 员 变 量 被 重 构 或 者 移 除 时 ， 该 方法 
可 以 简化 代码 的 维护 工作 。 这 样 做 有 助 于 产生 编译 时 错误 ， 从 而 避免 了 隐藏 在 SQL 字符 串 中 的 环 手 的 运行 时 错误 。 接 下 来 就 使 用 
上 还 技 术 来 定义 Category 类 ， 我 们 会 为 数据 库 表 和 表 列 声明 public static final 类 型 的 变量 : 


aDatabaseTable(tableName = Category.TABLE NAME) <q 
public class Category { 人 OO 措 定 表 名 
public static final String TABLE NAME = "categories", 
ID COLUMN = " id", 
NAME COLUMN = "name", 
PARENT COLUMN = "parent"; 
name 
成 员 不 


在 Data- private int id; 
baseField 

中 指定 列 
名 


> QDatabaseField(generatedId = true, columnName = ID. COLUMN) ? 


@DatabaseField(canBeNull = false, columnName = NAME COLUMN) 
private String name; 


@DatabaseField(foreign = true, columnName = PARENT COLUMN) « 标记 为 
AIN 

private Category parent; O sia 
JN 


public Category() ( 
} 


这 里 的 附加 内 容 很 多 ， 我 们 还 没有 全 部 实现 。 现 在 ， 我 们 在 DatabaseTable@ 注 解 里 指定 了 数据 库 表 名 ， 在 
DatabaseField@ 注 解 里 指定 了 表 的 列 名 。 我 们 可 以 在 应 用 程序 中 的 任何 地 方 使 用 这 些 public 变 量 用 于 查询 。 


此 外 ， 我 们 要 求 name 成 员 不 能 为 空 〈 黔 认 情况 下 ， 列 值 可 以 为 空 ) @。 最 后 ， 考 虑 下 parent 成 员 上 使 用 的 注解 。 在 我 们 的 
关系 模 型 中 ， 任 何 馈 定义 为 数据 库 表 的 成 员 变 量 必须 使 用 foreign=true@ 标 记 为 外 键 。 外 键 用 于 指示 ORM Lite 只 在 当前 表 中 和 存 
储 外 部 对 象 的 ID。 更 进一步 讲 ， 我 们 可 以 确保 父 分 类 必须 仓 任 。parent 的 成 员 变 量 声明 如 下 所 示 : 


aDatabaseField(foreign = true, foreignAutoRefresh = true, 
columnName = PARENT COLUMN, columnDefinition = "integer references " + 
TABLE NAME + "(" + ID COLUMN + ") on delete cascade") 


private Category parent; 


我 们 可 以 使 用 columnDefinition 定 义 列 来 微调 SQL 语 句 。 这 里 我 们 指定 parent 列 有 一 个 外 键 指 同 categories 表 (外 键 的 值 
定义 在 该 表 中 ) 。 这 表明 parent 列 的 值 要 么 是 空 ， 要 么 存在 于 categories 表 的 id 列 中 。 我 们 还 指定 当 parent 指 向 的 分 类 被 删除 
时 ，parent 的 记录 也 会 被 删除 ， 这 束 是 级 联 删 除 。 级 联 删 除 并 不 是 数据 库 要 求 的 ， 但 是 为 了 演示 ， 我 们 在 代码 中 包含 这 部 分 内 
容 。 为 Category 类 创建 数据 库 表 的 SQL 语 句 如 下 所 示 : 


CREATE TABLE 'categories' ('parent' integer references categories( id) 
on delete cascade, 'name' VARCHAR NOT NULL , 
' id' INTEGER PRIMARY KEY AUTOINCREMENT ) 


本 节 最 后 一 个 概念 是 为 一 个 或 者 多 个 列 指定 唯一 性 约束 。 要 实现 文章 和 分 类 之 间 的 多 对 多 关系 ， 需 要 一 个 交 义 引用 表 。 简 单 
讲 ， 交 叉 引 用 表 用 于 将 一 个 表 中 的 实体 与 男 一 个 表 中 的 实体 相 匹 配 。 因 此 ， 我 们 定义 一 个 具有 两 个 列 的 表 ， 用 于 匹配 articles 表 
的 ID 和 categories 表 的 ID， 从 多 辑 上 和 存储 文章 和 分 类 的 从 属 天 系 。 作 为 额外 检查 ， 交 勾引 用 表 通 常 包 含 一 个 约束 ， 该 约束 指定 相 
同 的 ID 组 合 只 能 在 表 中 出 现 一 次 。 为 了 表达 唯一 性 约束 ，ORM Lite 使 用 两 个 布尔 元 素 : unique 和 uniqueCombo。 下 述 的 
ArticleCategory 类 用 于 将 articles 表 映射 到 categories 表 ， 我 们 会 为 其 两 个 成 员 变 量 设置 uniqueCombo=true， 代 码 如 下 所 示 : 


@DatabaseTable(tableName = ArticleCategory.TABLE NAME) final Æ 4t 
public class ArticleCategory { 用 于 表示 
public static final String TABLE NAME = "articlecategories", -< Q 
ARTICLE ID COLUMN = "article id", 表 名 和 列 
CATEGORY ID COLUMN = "category id"; 和 
@DatabaseField(foreign = true, canBeNull = false, uniqueCombo = true, 
columnName - ARTICLE. ID COLUMN, 
columnDefinition = "integer references " + < 使 用 column- 
Article.TABLE NAME + m 
"(" + Article.ID COLUMN + ") on delete cascade") a "n 
private Article article; EA 
@DatabaseField(foreign = true, canBeNull = false, 
uniqueCombo = true, < V E foreign = true 
columnName - CATEGORY ID COLUMN, t s 
columnDetınıtıon = "integer reterences " + HITTENE LIRAT AR 
Category.TABLE_NAME + 
"(" + Category.ID COLUMN + ") on delete cascade") 


private Category category; 


public ArticleCategory() ( 
) 


注意 上 文 介绍 的 技术 的 用 法 ， 比 如 final 变 量 用 于 指定 表 名 和 人 列 名 @， 使 用 columnDe.nition 元 素 实现 引用 完整 性 @， 和 存储 复 
杂 对 象 时 需要 设置 foreign=true@。 最 终 创 建 表 的 SQL 语 句 如 下 所 示 : 


CREATE TABLE 'articlecategories' 
('article id' integer references articles( id) on delete cascade, 
'category id' integer references categories( id) on delete cascade, 
UNIQUE ('article id','category id') ); 


注意 生成 的 SQL 中 的 UNIQUE 语 句 。 


41.4 SQLiteOpenHelper 一 一 数据 库 通 道 


SQLiteOpenHelper 是 Android 提 供 的 抽象 类 ， 用 于 管理 开 友 者 与 存储 于 设备 上 的 数据 库 文件 之 间 的 交互 。 开 发 者 负责 创建 
SQLiteOpenHelper 的 子 类 ， 并 实现 两 个 方法 : onCreate () 和 onUpgrade () 。onCreate () 用 于 开发 者 指定 准确 的 数据 库 
schema, onUpgrade () 用 于 后 续 版 本 中 需要 改变 数据 库 schema 的 情 ; 


使 用 ORMLite 时 ， 不 需要 继承 SQLiteOpenHelper， 取 而 代 之 的 是 通过 继承 OrmLiteSqliteOpenHelper 来 利用 ORM 工 具 的 
优势 。 即 便 如 此 ， 仍 然 需 要 实现 onCreate () 和 onUpgrade () 万 法 。 笠 运 的 是 ， 当 企 类 中 声明 了 特定 的 注解 时 ， 所 有 后 续 工 


作 都 会 变 得 很 简单 。 我 们 会 用 到 TableUtils 类 的 静态 方法 创建 所 有 需要 的 表 。 在 确 层 ，ORMLite 会 通过 java 反射 机 制 相 天 的 API 
读 取 注解 并 构建 之 前 我 们 所 看 到 的 创建 数据 库 表 的 SQL 语 句 。 


现在 ， 比 较 困 难 的 工作 已 经 完成 ，onCreate () 方法 的 实现 代码 如 下 所 示 : 


QOverride 
public void onCreate(SQLiteDatabase sqLiteDatabase, 
ConnectionSource connectionSource) { 
try í( 
TableUtils.createTable(connectionSource, Category.class); 
TableUtils.createTable(connectionSource, Article.class); 
TableUtils.createTable(connectionSource, ArticleCategory.class); 
TableUtils.createTable(connectionSource, Author.class); 
TableUtils.createTable(connectionSource, ArticleAuthor.class); 
TableUtils.createTable(connectionSource, Comment.class); 
) catch (SQLException e) { 
Log.e(TAG, "Unable to create tables.", e); 
throw new RuntimeException(íe); 


注意 ， 使 用 外 键 时 ， 上 述 语句 有 严格 的 顺序 。 既 然 Article-Category 对 应 的 表 引 用 了 Article 和 Category 对 应 的 表 ， 因 此 
ArticleCategory 对 应 的 表 必须 在 其 依赖 的 表 创 建 之 后 再 创建 。 


在 运行 时 ， 当 ORMLite 第 一 次 用 于 操作 数据 库 时 ，onCreate () 方法 融会 疏 调 用 。 此 时 ， 碍 看 logcat 的 输出 ， 读 者 会 上 友 现 
在 这 个 创建 过 程 中 使 用 的 完整 SQL 语 句 。 举 例如 下 : 


INFO/TableUtils(2075): executed create table statement changed 1 rows: 
CREATE TABLE 'categories' 

('parent' integer references categories( id) on delete cascade, 

'name' VARCHAR NOT NULL , ' id' INTEGER PRIMARY KEY AUTOINCREMENT ) 


对 于 onUpgrade () 方法 的 实现 ， 每 个 应 用 程序 的 每 个 升级 流程 都 可 能 不 同 。 在 最 简单 的 实现 中 ， 首 先 通过 
TableUtils.dropTable () 方法 丢弃 每 个 表 ， 然 后 调用 onCreate () 方法 。 开 发 时 ， 请 仔细 确认 在 最 终 产品 中 ， 是 否 会 丢失 用 
户 数据 。 在 一 个 比较 稳妥 的 实现 中 ， 首 先 需 要 将 遗留 数据 导入 新 的 数据 库 schema， 然 后 ， 如 果 有 必要 就 执行 更 改 数据 库 表 的 数 
据 ， 最 后 ， 只 在 不 再 需要 某 个 表 的 时 候 才 丢弃 该 表 。 


_ 


最 后 ， 因 为 我 们 将 该 应 用 程序 的 运行 目标 定位 在 API Level 8 及 以 上 ， 所 以 可 以 使 用 外 键 。 然 而 ， 支 持 外 键 的 功能 在 默认 情 
况 下 并 没有 开启 。 要 支持 外 键 ， 需 要 执行 一 条 SQL 语句 ， 可 以 通过 重 写 onOpen () 方法 ， 在 打开 数据 库 时 执行 这 条 SQL 语句 ， 
代码 如 下 所 示 : 


QOverride 

public void onOpen(SQLiteDatabase db) ( 
super.onOpen(db); 
db.execSQL("PRAGMA foreign keys-ON;"); 


41.5 “用 于 数据 库 访问 的 单 例 模式 


我 们 在 应 用 程序 中 以 单 例 的 形式 使 用 上 一 节 中 实现 的 Orm-LitesqliteOpenHelper 的 子 类 。 通 过 维护 该 助手 类 的 单一 实例 ， 
应 用 程序 可 以 持 有 对 SQLite 数 据 库 的 单一 连接 。 实 践 中 ， 这 可 以 消除 在 同一 时 间 多 个 连接 同时 写 数据 的 风险 ， 避 免 运行 时 错 
误 。 

我 们 的 模型 中 包含 一 个 过 程 ， 该 过 程 保证 子 类 DatabaseHelper 只 有 一 个 实例 。 由 于 Android 在 底层 的 Java 锁 机 制 ， 该 实例 
可 以 在 多 线程 环境 中 安全 使 用 。 单 例 模式 的 实现 代码 如 下 所 示 (为 了 简单 起 见 ， 非 单 例 部 分 的 代码 不 予 显示 ) : 


public class DatabaseHelper extends OrmLiteSqliteOpenHelper { 
public static final String DATABASE NAME - "demo.db"; 
private static final int DATABASE VERSION = 1; 


private static DatabaseHelper instance; 


public static synchronized DatabaseHelper getInstance (Context c) { 


if (instance -- null) 
instance - new DatabaseHelper(c); 
return instance; ji diaii 
} 指定 数据 
| 库 文件 名 
private DatabaseHelper(Context context) { pones 
a | E 


super (context, DATABASE_NAME, null, DATABASE_VERSION); 
} 


在 private 构 造 万 法 中 ， 指 定 了 数据 库 文 件 名 及 其 版 本 号 。 传 入 构造 方法 的 版 本 号 与 前 述 小 节 中 提 到 的 onUpgrade () 方法 
一 起 使 用 。 


41.6 ”CRUD 操 作 一 点 通 
数据 库 开发 者 在 讨论 应 用 程序 需求 的 时 候 ， 经 常会 提 到 CRUD (create, read, update, and delete, 创建 、 读 取 、 更 新 
和 删除 操作 ) 这 个 缩写 词 。 我 们 会 探讨 如 何在 实现 的 Java 类 中 处 理 上 述 操作 。 


我 们 通过 ORM Lite 提 供 的 一 个 称 为 DAO (data access object， 数 据 访问 对 象 ) 的 类 来 访问 数据 库 中 的 对 象 。DAO 是 一 个 
泛 型 类 ， 有 两 个 泛 型 参数 : 需要 持久 化 的 对 象 的 类 型 、 对 象 1D 的 类 型 。 对 于 没有 ID 的 交叉 引用 对 象 而 言 ， 例 如 


ArticleCategory， 我 们 使 用 Void 作 为 泛 型 参数 。 在 DatabaseHelper 单 例 中 ,我们 以 指定 类 为 参数 调用 getDao () 737A, Win] 
以 得 到 每 个 类 对 应 的 DAO 对 象 。 从 方便 的 角度 看 ， 读 者 会 发 现 上 述 方 法 可 以 根据 实际 的 泛 型 参数 来 转化 返回 结果 ， 正 如 下 述 示 
例 代 码 所 示 。 我 们 会 在 示例 程序 中 大 量 使 用 这 种 惯用 方法 。 


public class DatabaseHelper extends OrmLiteSqliteOpenHelper { 
/* Remainder omitted */ 


public Dao«Article, Integer» getArticleDao() throws SQLException ( 
return getDao(Article.class); 


得 到 了 DAO 对 象 ， 就 可 以 通过 其 暴露 的 大 量 方法 创建 、 更 新 、 删 除 和 查询 数据 库 对 象 。 假 如 要 在 数据 库 中 创建 一 条 
Category 记 录 ， 只 需要 创建 一 个 Category 实 例 ， 用 需要 持久 化 的 信息 填充 该 实例 ， 然 后 调用 DAO 提 供 的 create () 方法 即 
可 ，ORMLite 会 将 数据 库 指定 的 ID 值 设置 给 相应 对 象 。 假 设 我 们 希望 创建 两 个 Category， 其 中 一 个 Category 需 要 内 套 在 另 一 个 
Category 中 ， 可 以 通过 以 下 代码 实现 这 种 需求 : 


Category tutorials = new Category(); < 创建 所 需 对 象 3k HX Database- 

tutorials.setName("Tutorials"); Helper 单 例 类 
的 实例 

DatabaseHelper helper = DatabaseHelper.getInstance(context) 二 H P 


Dao«Category, Integer» categoryDao = helper.getCategoryDao(); 


categoryDao.create(tutorials); z—— 调用 create 方法 


Tutorials XJ 22 ix 
置 了 自己 的 ID， 


Category programmingTutorials; 


HI 以 在 新 的 Cate- 

String title = "Programming Tutorials"; 可 以 在 新 的 Cate 

Am 

programmingTutorials = new Category(title, tutorials); id gory "P H fF 4 
categoryDao.create(programmingTutorials); Category 


读 取 一 个 指定 ID 的 对 象 ， 只 需要 简单 地 调用 DAO 提 供 的 queryForld () 方法 。DAO 还 提供 了 更 新 和 删除 一 个 对 象 的 方法 ， 
使 用 起 来 同样 简单 。 传 入 一 个 已 经 设置 过 ID 的 对 象 ， 上 述 操作 可 以 很 简单 地 实现 ， 假 设 已 经 知道 在 上 段 代 码 中 创建 的 第 一 个 数 
据 记 录 的 ID， 可 以 通过 以 下 代码 重 命名 该 记录 : 


Category renamed - new Category(1, "Android Tutorials", null); 
categoryDao.update(renamed); 


也 可 以 删除 该 记录 ， 万 法 很 简 音 : 


Category toDelete = new Category(); 
toDelete.setId(2); 
categoryDao.delete(toDelete); 


执行 更 新 操作 时 ， 重 要 的 一 点 是 填充 源 对 象 的 所 有 相关 成 员 变 量 。 执 行 删除 操作 时 ， 仅 仅 需 要 传 入 ID 值 。 在 上 述 示例 中 ， 
当然 也 可 以 将 初始 对 象 tutorials 和 programmingTutorials 分 别传 入 到 update 和 delete 方 法 中 。 


41.7 AAE 


操作 数据 库 中 的 单一 记录 是 比较 简单 的 ， 这 里 分 析 几 种 复杂 操作 ， 例 如 返回 多 个 记录 的 复杂 查询 、 更 新 和 删除 多 条 记录 以 及 
使 用 QueryBuilder、UpdateBuilder 和 DeleteBuilder 类 。 所 有 这 些 操作 都 可 以 通过 DAO 对 象 分 别 调用 queryBuilder () . 
updateBuilder () 和 deleteBuilder () 方法 来 实现 。 


首先 ， 写 一 个 查询 ， 用 于 返回 数据 库 中 所 有 顶层 Category。 我 们 仍然 使 用 之 前 实现 的 那个 泛 型 参数 为 
Dao«Category, Integer» BSDAOXJZ: 


PreparedQuery«Category» query - categoryDao.queryBuilder() 
.SelectColumns(Category.NAME COLUMN) 
.where() 


.isNull(Category.PARENT COLUMN) 


.prepare(); 
List«Category» topLevelNames - categoryDao.query(query); 


QueryBuilder 中 定义 的 方法 可 以 使 用 特有 的 SQL 运算 符 生 成 一 条 查询 语句 。 开 上 友 者 可 以 组 合 使 用 and () . or O . zmtB 
等 的 eq () 、not () 、 表 示 大 于 或 者 等 于 的 ge 0 以 及 其 他 方法 来 生成 where 子 句 。QueryBuilder 以 及 与 其 类 似 的 用 于 更 新 
和 删除 的 相关 类 都 采用 流畅 接口 (fluent interface) ,流畅 接 口 意味 着 每 个 方法 都 返回 相同 对 象 的 引用 ， 因 此 开发 者 通常 使 用 
链 式 调用 的 方式 一 起 调用 这 些 方法 以 提高 可 读 性 。 


在 上 例 中 ， 我 们 调用 selectColumns () 方法 并 为 该 方法 指定 数据 库 中 哪些 列 需要 填充 到 最 终 返 回 的 对 象 中 (只 有 name 
列 ) ， 这 样 便 对 数据 库 做 了 一 次 投影 1!」 (projection) 。 明 确 表达 查询 语句 后 ， 调 用 QueryBuilder 定 义 的 prepare () 方法 ， 返 
回 一 个 PreparedQuery 类 型 的 实例 。 将 上 述 实例 传 入 query() 方法 便 可 以 返回 顶层 Category。 


继续 分 析 构 建 器 ， 我 们 多 分 析 一 些 例子 。 假 设 给 定 一 个 父 Category 的 ID 值 ， 以 parentld 表 示 ， 需 要 根据 该 ID 来 计算 其 子 
Category 的 数量 。 可 以 首先 使 用 QueryBuilder 定 义 的 另 一 个 方法 来 提示 需要 执行 计数 操作 ， 该 万 法 为 setCountOf () ， 然 后 调 
用 DAO 中 定义 的 countOf () 方法 实现 计数 操作 : 


PreparedQuery«Category» countQuery = categoryDao.queryBuilder() 
.sSetCountOf(true) 
.where() 
.eq(Category.PARENT COLUMN, parentId) 
.prepare(); 

long children = categoryDao.countOf(countQuery); 


删除 操作 是 相似 的 。 假 设 需要 运行 一 条 删除 语句 以 删除 所 有 30 天 前 的 文章 。 可 以 使 用 DeleteBuilder 类 完成 上 述 需求 ， 代 码 
如 下 所 示 : 


Calendar cutoff = Calendar.getInstance(); 
cutoff.add(Calendar.DATE, -30); < &p 计算 日 期 
PreparedDelete«cArticle» deleteStatement; 

deleteStatement = (PreparedDelete«cArticle»)articleDao 


HJ 建 © .deleteBuilder() 
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articleDao.delete(deleteStatement); 


详细 分 析 上 面 的 例子 。 首 先 ， 计 算出 30 天 前 的 日 期 @。 然 后 ， 使 用 | 此 () 函数 来 构建 where 子 句 @， 该 子 句 表示 应 该 删除 小 
于 给 定 日 期 的 值 。 最 后 ， 调 用 prepare () 方法 后 @， 必 须 将 返回 值 类 型 转换 为 PreparedDelete。 需 要 类 型 转换 的 原因 是 DAO 
中 定义 的 delete () 方法 不 接受 PreparedQuery 类 型 的 参数 ， 而 prepare () 方法 返回 的 对 象 正 是 PreparedQuery 类 型 。 提 前 知 
道 这 种 转换 是 正确 的 。 注 意 ， 在 比较 操作 中 ， 例 如 小 于 操作 ， 必 须 仔细 检查 ， 以 确保 传 入 ORM 的 数据 类 型 与 类 中 定义 的 数据 类 
型 一 致 。 本 例 中 ， 传 入 的 是 Date， 该 数据 对 应 的 是 Article 类 的 成 员 变 量 : 


private Date publishedDate; 


文章 被 删除 时 ， 必 须 确保 数据 完整 性 得 到 维护 。 在 本 例 中 ， 数 据 完 整 性 意味 着 我 们 通过 上 述 语句 删除 的 ID 值 不 应 该 出 现在 
Article 与 Category 的 交叉 引用 表 中 ， 类 似 地 ， 访 ID 值 也 不 应 该 出 现在 Comment 类 对 应 的 表 中 。 笠 运 的 是 ， 删 除 语 句 还 有 一 个 
隐藏 功能 可 以 实现 上 述 需 求 。 因 为 在 早期 设计 数据 库 schema 时 ， 我 们 殊 留 意 到 这 点 ， 因 此 我 们 为 ArticleCategory 类 指定 了 级 联 
删除 来 维护 数据 完整 性 。 我 们 也 可 以 在 实现 Comment 类 时 ， 使 用 相同 策略 。 因 此 ， 上 述 删 除 语句 除了 需要 删除 文章 本 身 ， 还 要 
删除 与 文章 相关 的 任何 评论 以 及 该 文章 与 其 分 类 的 映射 数据。 


上 述 这 些 例 子 只 是 我 们 可 以 使 用 构建 对 象 执行 的 一 些 类 型 的 语句 。 一 个 完整 的 应 用 程序 可 能 会 包 合 更 多 增删 改 查 的 组 合 使 
用 。 此 外 ， 我 们 还 没有 触及 一 些 玉 手 的 主题 ， 例 如 处 理 外 部 对 象 引用 以 及 查询 多 表 数 据 时 的 可 用 选项 。 


[1] 投影 是 数据 库 理论 的 核心 概念 之 一 ， 用 于 从 数据 库 表 中 查询 或 显示 一 部 分 列 。 
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到 目前 为 止 ， 我 们 可 以 令 ORMLite 处 理 Java 类 型 与 SQLite 存 储 类 型 之 间 的 映射 。 不 过 ， 我 们 还 没有 展示 从 多 表 中 查询 数据 
的 复杂 查询 操作 。 幸 运 的 是 ， 之 前 ， 我 们 在 创建 数据 库 schema 时 使 用 过 注解 ， 我 们 可 以 使 用 相同 的 注解 来 调整 ORM Lite 的 行 


我 们 可 以 完成 的 最 简单 的 更 改 是 改变 成 员 变 量 的 存储 类 型 ， 例 如 日 期 类 型 。 默 认 情况 下 ，ORMLite 会 把 java.util.Date 映 射 
为 VARCHAR， 并 且 以 yyyy-MM-dd HH: mm: ss.SSSSSS 的 格式 存储 日 期 。 例 如 ， 我 们 想 以 数字 形式 存储 日 期 (比如 从 纪元 
开始 至 今 经 历 的 毫秒 数 ) ， 我 们 可 以 在 Article 类 中 使 用 下 述 修改 后 的 注解 : 


@DatabaseField(canBeNull = false, dataType = DataType.DATE LONG, 
columnName - PUBLISHED DATE COLUMN) 
private Date publishedDate; 


上 述 代 码 会 生成 一 条 创建 数据 库 表 的 语句 ， 并 且 使 用 BIGINT 类 型 存储 日 期 。 


现在 ,我 们 考虑 有 人 外 部 引用 对 象 的 情况 。 已 知 Category 可 以 有 父 分 类 ， 但 是 ， 当 我 们 检索 一 个 有 父 分 类 的 Category 
时 ，ORM 应 该 怎么 处 理 呢 ? 应 该 返回 父 分 类 的 全 部 内 容 吗 ? 那么 父 分 类 的 父 分 类 呢 ? ORMLite 引 入 了 foreign auto refresh 来 
处 理 上 述 行为 ， 并 且 提 供 了 foreign refresh level 实 现 可 配置 化 。 在 默认 情况 下 ， 碍 询 一 个 Category 时 ， 会 设置 其 父 分 类 ， 不 过 


只 会 设置 父 分 类 的 1D 信息 。 从 ORM 执 行 SQL 查 询 的 角度 看 ， 默 认 行为 是 最 有 效率 的 。 当 开局 目 动 刷新 功能 时 ， 开 发 者 应 该 意识 
到 有 可 能 存在 大 量 语句 同时 执行 的 情况 。 截 止 本 书写 作 时 友 布 的 版 本 (4.41) 并 不 会 执行 数据 库 连接 (join) 操作 ， 取 而 代 之 的 
是 执行 扩展 语句 。 

下 面 介 绍 一 个 一 对 一 关系 的 具体 案例 。 假 如 我 们 希望 Category 的 父 分 类 总 是 可 以 被 刷新 ， 我 们 可 以 在 父 分 类 对 应 的 成 员 变 


量 的 注解 中 设置 foreignAutoRefresh=true， 如 下 所 示 : 


@DatabaseField (foreign = true, foreignAutoRefresh = true, 
canBeNull = true, columnName = PARENT COLUMN, 
columnDefinition = "integer references " + TABLE NAME + 


"(" + ID COLUMN + ") on delete cascade") 
private Category parent; 


开局 上 述 功 能 时 ，ORMLite 默 认 会 执行 2 级 刷新 。 对 于 上 述 代码 定义 的 注解 ，ORMLite 会 填充 Category、Category 的 父 分 
类 以 及 父 分 类 的 父 分 类 (如 果 有 的 话 ) 。 可 以 在 注解 中 使 用 maxForeignAutoRefreshLevel 元 素来 改变 默认 的 2 级 刷新 。 忆 之 ， 
将 上 述 元 素 的 值 修改 为 1 是 比较 常见 的 情况 (此 外 ， 增 加 该 值 会 导致 更 多 SQL 查 询 语句 被 执行 ) 。 


现在 ,假设 我 们 对 “一 对 多 ”关系 感 兴趣 ， 例 如 一 篇 文章 可 以 对 应 多 条 评论 的 情况 。 我 们 可 以 在 Article 类 中 引入 一 个 成 员 变 
量 ， 并 且 将 该 变量 注解 为 一 个 ForeignCollectionField。 我 们 可 以 使 用 该 注解 指定 评论 刷新 的 方式 : 或 者 使 用 人 工 选择 的 方式 刷 
新 所 有 评论 ， 或 者 在 文章 加 载 时 目 动 刷新 所 有 评论 ， 融 像 eager 元 素 中 指定 的 那样 。 源 码 如 下 所 示 : 


aDatabaseTable(tableName = Article.TABLE NAME) 
public class Article ( 


QaForeignCollectionField(eager = true) 
private ForeignCollection«Comment» comments; 


对 于 上 述 定义 ，ORMLite 不 会 为 Article 类 对 应 的 数据 库 表 添加 任何 额外 的 列 。 取 而 代 之 的 是 ，ORMLite 会 生成 一 个 DAO， 


用 于 查询 与 每 篇 文章 相关 联 的 所 有 评论 。 读 者 或 许 会 最 识 到 ， 当 查询 多 篇 有 很 多 注释 的 文章 时 ， 运 行 成 本 会 很 大 。 因 此 ， 我 们 看 
看 如 何 使 用 非 eager 的 方式 收集 数据 ， 这 或 许 会 很 棘手 。 我 们 从 注解 中 移 除 eager=true 元 素 (默认 为 false) : 


aForeignCollectionField 
private ForeignCollection«Comment» comments; 


根据 现在 的 配置 ， ORM Lite 默 认 不 会 检索 与 文章 相 天 的 评论 。 但 是 ， 在 处 理 comments 变 量 时 ， 我 们 必须 非 党 小心， 因为 
其 类 型 是 ForeignCollection。 当 一 个 Collection 是 非 eager 时 ， 触 上 Collection 上 的 任何 方法 都 会 导致 WO 操作 ， 例 如 size () 和 
iterator () 方法 。 此 外 ， 调 试 器 可 能 正在 调用 iterator () 方法 ， 这 样 会 导致 不 可 预料 的 |/O 操 作 并 产生 一 个 被 填充 了 奇怪 数据 
的 Collection。ORMLite 开 发 文档 建议 在 Collection 上 使 用 toArray () 方法 来 填充 这 种 形式 的 Collection。 下 面 介 绍 了 一 个 例 


子 ， 用 于 加 载 某 篇 义 草 及 其 所 有 评论 : 


DatabaseHelper helper - DatabaseHelper.getInstance(context); 
Dao«Article, Integer» articleDao = helper.getArticleDao(); 


Article article; 





article = articleDao.queryForId(1); 4—— WRA 
Comment[] comments; 加 和 载 所 
comments = article.getComments().toArray(new Comment[0]); < 有 评论 


最 后 ， 请 查看 这 篇 文档 (http//mng.bz/84k8) ， 该 文档 介绍 了 如 何在 迭代 器 (iterator) 上 正确 调用 close () 方法 ， 例 
ql, iXX jnILARFI MAForeignCollectionz&BXB Xf ss. 
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编写 一 条 SQL 查 询 语 句 往往 比 依 赖 于 ORM 工 具 构 建 和 执行 所 需 的 查询 更 有 效率 。 当 处 理 多 表 数 据 查 询 的 时 候 ， 比 如 上 文 提 
到 的 具有 外 部 引用 对 象 的 情况 ， 这 种 方法 残 派 上 用 场 了 。 在 性 能 要 求 严 格 的 领域 ， 一 条 SQL 连接 语句 (oin) 的 效率 要 比 依赖 于 
DAO 方 法 目 动 更 新 对 象 或 者 人 工 选择 式 更 新 对 象 的 效率 高 的 多 。 


要 执行 原生 SQL 查询 ， 需 要 首先 获取 一 个 DAO ， 然 后 调用 queryRaw () 方法 的 某 个 重 载 方法 。 每 个 queryRaw () 方法 的 
签名 中 都 以 一 个 可 变数 量 的 字符 串 作为 最 后 一 个 参数 。 这 是 为 了 让 开 友 者 可 以 将 查询 语句 参数 化 ， 并 通过 ORM 来 转 义 
(escaping) 其 取 值 。 这 对 于 需要 基于 用 户 输入 来 执行 某 些 查 询 操 作 的 情况 是 很 重要 的 ， 如 果 处 理 不 好 ， 数 据 库 束 会 暴露 在 
SQL 注入 攻击 (SQL injection attack) 之 下 。 

queryRaw () 方法 的 重 载 方法 允许 我 们 对 得 到 的 查询 结果 集 的 类 型 进行 微调 ， 可 选 的 微调 类 型 如 下 所 示 : 

-String 数组 的 列表 ， 每 个 结果 对 应 一 个 数组 ， 每 个 数组 保存 所 选 数据 列 的 原始 字符 串 。 

: Object 数组 的 列表 ， 每 个 结果 对 应 一 个 数组 ，Object 的 具体 类 型 由 输入 类 型 决定 。 


| 自 定 义 类 的 列表 ， 需 要 用 到 参数 化 的 RawRowMapper.; 


由 于 使 用 RawRowMapper 解 释 更 充分 ， 而 且 代 码 更 易于 复 用 ， 所 以 我 们 以 RawRowMapper 为 例 。 假 设 我 们 需要 得 到 数据 
库 中 所 有 文章 的 列表 以 及 文章 所 属 分 类 的 名 字 (还 有 ID 号 ) 。 使 用 ORM 完 成 上 述 操作 会 执行 大 量 查 询 操 作 ， 并 且 查 询 操 作 的 数 
量 与 数据 库 中 条 目的 数量 是 成 比例 的 。 我 们 可 以 只 使 用 一 条 查询 语句 来 优化 上 述 操作 ， 这 条 查询 语句 需要 连接 (join) 三 个 表 : 
Article、Category 以 及 交叉 引用 表 ArticleCategory， 查 询 语 句 如 下 所 示 : 
select a.title, a. id, c.name, c. id from articles a, categories c, 


articlecategories ac 
where ac.article id = a. id and ac.category id = c. i8; 


首先 ， 定 义 一 个 类 来 接收 查询 结果 : 


class ArticleCategoryName { 
public String articleTitle, categoryName; 
public Integer articleId, categoryIgd; 


然后 ， 我 们 提供 一 个 RawRowMapper 实 现 类 ， 该 类 会 被 应 用 于 查询 语句 返回 的 每 条 记录 ， 其 作用 是 将 原始 String 数 组 转化 
为 开发 者 期 望 的 类 型 ， 而 原始 String 数 组 存储 的 正 是 数据 库 返 回 的 列 信息 。 在 本 例 中 ， 要 转化 的 期 望 类 型 是 
ArticleCategoryName (注意 泛 型 的 使 用 ) : 


class ArticleWithCategoryMapper 
implements RawRowMapper«ArticleCategoryName» { 


QOverride 

public ArticleCategoryName mapRow(String[] columnNames, 
String[] resultColumns) throws SQLException { 
ArticleCategoryName result = new ArticleCategoryName(); 
result.articleTitle - resultColumns[0]; 
result.articlelid = Integer.parselInt(resultColumns[1]); 
result.categoryName = resultColumns[2]; 
result.categoryId - Integer.parseInt(resultColumns[3]); 


return result; 


解析 mapRow () 方法 中 的 result 时 ， 检 查 数 据 一 致 性 是 很 重要 的 。 将 所 有 功能 整合 在 一 起 ， 我 们 可 以 通过 下 面 的 代码 获取 
所 有 文章 名 称 及 其 所 属 分 类 的 列表 : 


GenericRawResults<ArticleCategoryName> rawResults; 


String query = "select a.title, a. id, c.name, c. id from articles a, 
categories c, articlecategories ac 
where ac.article id = a. id and ac.category id = c. id"; 
ArticleWithCategoryMapper mapper = new ArticleWithCategoryMapper(); 
rawResults - articleDao.queryRaw(query, mapper); 
List«ArticleCategoryName» results - rawResults.getResults(); 
41.10 事务 


事务 (Transaction) 是 数据 库 操作 的 重要 组 成 部 分 。 事 务 允许 将 多 条 数据 库 操作 语句 视 为 一 个 原子 单元 。 一 个 事务 需要 保 
证 以 下 两 种 可 能 情况 中 的 一 种 会 友 生 。 


“ 如 果 没 有 错误 发 生 ， 所 有 数据 库 语 名 都 会 被 执行 并 提交 。 


- 如 果 在 事务 的 任何 一 个 执行 点 发 生 错误 ， 整 个 事务 都 需要 被 回 滚 (roll back) 。 


为 了 便于 使 用 事务 ，ORMLite 提 供 了 一 个 名 为 Transaction-Manager 的 类 ， 该 类 封装 了 开始 事务 、 标 记事 务 成 功 以 及 结束 
事务 的 细节 。TransactionManager 只 暴露 了 一 个 calllnTransaction () 方法 ， 该 方法 接收 一 个 Callable 参 数 ， 该 参数 类 似 于 


Runnable， 只 是 多 了 一 个 返回 值 。 


为 了 运行 一 个 事务 ， 我 们 在 DatabaseHelper 的 子 类 OrmLite-SqliteOpenHelper 中 提供 事务 的 特性 : 


public class DatabaseHelper extends OrmLiteSqliteOpenHelper { 


public «T» T callInTransaction(Callable«T» callback) ( 
try 1 
TransactionManager manager; 
manager = new TransactionManager(getConnectionSource()); 
return manager.calllInTransaction(callback); 


) catch (SQLException e) { 
Log.e(TAG, "Exception occurred in transaction.", e); 
throw new RuntimeException(íe); 


15115855 H ss SE rS ER ERMECallablerh, sx. FAMA ARAE, VAJGIATESOSUBEMG f WUAXSSSRME, 
并 返回 Article。 


public Article createArticleInCategory(Context context, 
final String title, final String text, final Category category) ( 


final DatabaseHelper helper = DatabaseHelper.getiInstance(context); 
return helper.callInTransaction(new Callable-cArticle»() ( 
aGOverride 新 建 
使 用 DAO public Article call() throws SQLException { Article 
| : Article article - new Article(new Date(), text, title); ^ 实例 
到 数据 库 Dao<Article, Integer» articleDao; 
Dnm articleDao - helper.getArticleDao(); SR Hin Px x 
中 l ， 添加 交叉 
articleDao.create(article); 


引用 实例 
Dao«ArticleCategory, Void» articleCategoryDao; <H 
articleCategoryDao = helper.getArticleCategoryDao(); 


articleCategoryDao.create(new ArticleCategory(article, category)); 


return article; 


在 本 例 中 ， 使 用 数据 库 事 务 是 为 了 保证 两 次 写 操作 同时 成 功 ， 如 果 任何 一 次 写 操作 失败 ， 所 有 写 操作 都 不 会 被 提交 到 数据 库 
中 。 当 需要 执行 多 次 写 操作 ， 为 了 保持 数据 一 任性 ， 使 用 事务 是 值得 推荐 的 方法 。 此 外 ， 在 一 些 情况 下 ， 事 务 可 以 提高 多 条 组 合 
语句 的 性 能 ， 特 别 是 读 写 操作 混用 的 情况 。 


41.11 LER 
ORMLite 可 以 大 大 简化 Android 应 用 程序 的 数据 库 开 友 。 只 要 正确 注解 了 Java 类 ， 束 可 以 通过 ORMLite 创 建 整个 数据 库 实 
例 。ORMLite 还 可 以 处 理 数据 库 查 询 结 果 与 类 实例 之 间 的 映射 ， 这 样 就 不 需要 编写 大 量 样板 代码 了 。 


对 于 需要 处 理 多 张 数据 库 表 等 性 能 要 求 严格 的 操作 ， 考 虑 手工 编写 join 语 句 ， 然 后 使 用 DAO 提 供 的 queryRaw () 方法 。 在 
实践 中 ， 这 种 方式 会 比 逐 一 查询 依赖 的 附加 表 要 高 效 的 多 ， 正 如 ORM 生 成 语句 的 例子 。 此 外 ， 考 虑 使 用 事务 来 批量 处 理 多 个 写 
操作 以 确保 数据 一 致 性 。 最 后 ， 建 议 为 SQLiteOpenHelper 的 子 类 使 用 单 例 模式 以 避免 多 线程 同时 执行 写 操作 时 出 现 问题 。 


41.12 ”外 部 链接 


http://ormlite.com/javadoc/ormlite-core/doc-files/ormlite 1.html 
http://ormlite.com/javadoc/ormlite-core/doc-files/ormlite 2.htmltlI DX195 


http://touchlabblog.tumblr.com/post/24474750219/single-sglite-connection 


Hack42 ”为 SQLite 添 加 自 定义 功能 


Android v1.0 十 


Android 使 用 SQLite 作 为 内 置 数据 库 。 尽 管 Android 为 其 提供 了 民 好 的 API 接 口 ， 但 是 有 时 开 妈 者 还 是 会 感 党 到 接口 有 限 。 
如 果 想 用 一 种 比较 算法 为 查询 结果 排序 ， 读 者 应 该 怎么 做 ? 读者 有 没有 尝试 实现 一 种 查询 ， 通 过 这 个 查询 返回 GPS 中 两 个 坐标 之 
间 的 距离 ? SQLite 的 一 大 限制 是 缺乏 数学 消 数 ， 导 致 某 些 查询 无 法 实现 。 

在 这 个 Hack 里 ,我 会 展示 如 何 使 用 Android NDK 为 SQLite 提 供 目 定义 查询 的 功能 。 我 们 会 创建 一 个 应 用 程序 ， 访 应 用 程序 


使 用 目 定 义 SQLite 功 能 计算 存储 在 数据 库 中 的 两 个 不 同 POI (points of interest， 关 注 点 ) 间 的 距离 。 该 功能 会 用 到 POI 的 GPS 
坐标 ， 并 使 用 半 正 矢 公 式 (haversine formula) 以 公里 为 单位 返回 距离 信息 。 


我 们 可 以 在 图 42-1 中 看 到 应 用 程序 的 运行 结果 。 从 图 中 ， 我 们 可 以 看 到 添加 了 几 个 位 于 法 国 的 不 同 POI。 然 后 ， 用 户 使 用 巴 
黎 圣 母 院 (the Notre Dame de Paris) 的 GPS 坐标 搜索 ， 该 坐标 距离 不 同 POI 之 间 的 距离 便 显 示 出 来 。 


要 实现 上 述 功能 ， 我 们 会 用 到 Android NDK。 我 们 使 用 Java 创 建 PO1， 并 且 使 用 SQLiteOpenHelper 类 把 这 些 POI 插 入 到 数 
据 库 中 。 但 是 ， 用 户 搜 索 数据 库 的 时 候 ， 我 们 使 用 NDK。 先 看 看 如 何 实现 Java 部 分 ， 然 后 再 分 析 如 何 实现 NDK 部 分 的 代码 。 
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图 42-1 从 巴黎 圣母 院 到 位 于 法 国 的 不 同 POI 之 间 的 距离 





42.1 Java{tiB 


正确 实现 上 述 应 用 程序 的 思路 是 : 使 用 Java API 处 理 简单 的 数据 库 查 询 ， 只 有 在 需要 使 用 自 定 义 功 能 时 才 使 用 NDK。Java 
e RM MB 该 类 负责 在 必要 的 时 候 调 用 NDK。 


接 下 来 分 析 DatabaseHelper 的 代码 : 


public class DatabaseHelper extends SQLiteOpenHelper { 
public static final String DATABASE NAME = "pois.db"; 
private static final int DATABASE VERSION = 1; 
private Context mContext; 


static ( 


System.loadLibrary("hack042-native"); OI native Æ 
} 


public DatabaseHelper (Context context) { 


super (context, DATABASE NAME, null, DATABASE VERSION); 
mContext - context; 


) 


QGOverride 
public void onCreate(SQLiteDatabase db) ( 
db.execSQL("CREATE TABLE " + 
"pois (" + 1O POI 数据 库 表 的 schema 
" id INTEGER PRIMARY KEY AUTOINCREMENT," + 
"title TEXT," + 


"longitude FLOAT," + 
"latitude FLOAT);"); 
) 


QOverride 
public void onUpgrade(SQLiteDatabase db, int oldVersion, 
int newVersion) ( 
db.execSQL("DROP TABLE IF EXISTS pois;"); 


) e; getNear() 方法 的 
public List«Poi»getNear(float latitude, float longitude) (  . Java 实现 

File file - mContext.getDatabasePath(DATABASE NAME); 

return getNear(file.getAbsolutePath(), latitude, longitude); 


} 
private native List<Poi> getNear (String dbPath, float latitude, 
float longitude); < 一 一 getNear() 方 法 的 native 
Q 实现 的 方法 签名 


第 一 行 重要 代码 是 加 载 native 库 @。 通 常 从 static 代 码 块 中 调用 System.loadLibrary () ， 表 示 加 载 类 的 同时 加 载 名 为 
hack042-native 的 native 库 。 在 onCreate () 方法 中 @， 读 者 可 以 看 到 数据 库 schema 的 形式 。DatabaseHelper 类 定义 了 一 个 
getNear () 万 法 ， 该 方法 会 在 用 尸 点 击 Search 按 钮 的 时 候 调用 。 不 过 ， 上 述 方法 只 是 对 其 native 版 本 方法 的 封 濠 @，Java 版 
本 的 方法 是 public< 的 ， 这 是 因为 native 方 法 的 实现 需要 知道 数据 库 路 径 ， Re 


42.2 native 代码 


当 使 用 目 定义 功能 时 ,我 们 通过 NDK 查 询 数 据 库 。 要 完成 这 个 功能 ， 需 要 在 NDK 中 操作 SQLite， 这 意味 着 需要 编译 代码 。 
平 运 的 是 ， 这 比 想象 的 要 简单 。 我 们 只 需要 简单 地 添加 .c 和 .h 文 件 。 将 sqlite3.c 添 加 到 Android.mk 的 LOCAL _SRC_FILES 中 丈 可 
以 使 用 了 。 


在 main.cpp 中 实现 了 所 有 NDK 人 代码， 我 们 需要 完成 下 列 功 能 : 
- 使 用 INI 创建 Java 对 象 
“ 使 用 SQLite 的 C/C++API 查 询 数 据 库 
- 将 List<Poi> 以 jobject 形 式 返 回 


接 下 来 看 看 getNear () 万 法 的 实现 代码 : 


jobject Java, com manning androidhacks. hack042. db DatabaseHelper. getNear( 
JNIEnv *env, jobject thiz, jstring dbPath, 1 getNear() 
jf loat lat, jfloat lon l si; 
J J ) d native 方法 


sqlite3 *db; &p 
sqlite3 stmt *stmt; 
const char *path = env-»GetStringUTFChars(dbPath, 0); 


jclass arrayClass = env-»FindClass("java/util/ArrayList"); 
jmethodID mid init =  env-»GetMethodID(arrayClass, "«init»", "()V"); 
他 | 建 2 Jobject objArr = env->NewObject (arrayClass, mid init); 
o jmethodID mid add = env-»GetMethodID(arrayClass, "add", " (bjava/1lang/ 
Object;)2"); 
jclass poiClass = env-»FindClassq( 


Array- 
List 


"com.manning.androidhacks.hack042.model.Poi"); 
jmethodID poi mid init =  env-»GetMethodID(poiClass, "«init»", 
" (bjava/lang/String;FFF)V"); 根据 指定 路 径 打 


sqlite3 open(path, &db); <4 开 数 据 库 
env-»-ReleaseStringUTFChars (dbPath, path); 


sqlite3 create function(db, "distance", 4, SQLITE UTFS8, 4 创建 自 定 义 
NULL, &distanceFunc, NULL, NULL); Jit " 
JJH 


if (sqlite3. prepare(db, 
"SELECT title, latitude, longitude, 
创建 查询 > distance(latitude, longitude, ?, ?) as kms 
语句 FROM pois ORDER BY kms", 
-1, &stmt, NULL) == SQLITE OK) { 
int err; 
sqglite3 bind double(stmt, 1, lat); i 3 
sqlite3_bind_double(stmt, 2, lon); jii J ik In] 


while ((err = sqlite3 step(stmt)) == SQLITE ROW) { < 
const char *name = (char const *) 
sqlite3. column text(stmt, 0); 
jfloat latitude = sqlite3. column double(stmt, 1); 
jfloat longitude = sqglite3. column double(stmt, 2); 
jfloat distance = sqlite3. column double(stmt, 3); 


jobject poiObj = env-»NewObject(poiClass, 
poi, mid init, <4 | 新 建 POIl 
env-»NewStringUTF (name), | 
latitude, o^ 
longitude, 
distance); 


env-»CallBooleanMethod(objArr, mid add, poiObj); 


} 
if (err != SQLITE DONE) { 

LOGI ("Query execution failed: %s\n", sqlite3_errmsg (db)); 
} 


sqlite3_finalize(stmt); 


} else { 


乍 移 要 天 注 的 是 Java 和 NDK 方 法 釜 名 的 不 同人 四。 既然 需要 返回 List< Poi> ， 我 们 融 使 用 JNI 新 建 一 个 ArrayList@OD。 然 后 ， 可 
以 通过 指定 的 路 径 打 开 数 据 库 @， 并 且 通 过 传 入 一 个 函数 指针 创建 目 定 义 功 能 @。distance () 函数 定义 在 main.cpp 文 件 中 。 
目 定 义 功 能 创建 后 ， 融 可 以 使 用 distance () 锐 数 编写 坦 询 语句 ©。 最 后 一 步 是 遍历 返回 结果 @@， 使 用 原始 数据 创建 Poi 对 得 
Q@， 并 把 该 对 象 添加 到 列表 中 ，。 


现在 ， 所 有 native 都 已 经 实现 。 每 当 调用 DatabaseHelper 的 getNear () 方法 ， 访 方法 融会 用 到 本 节 中 实现 的 目 定 义 功 
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42.3 ”概要 


使 用 NDK， 听 起 来 会 增加 很 多 工作 量 ， 但 是 这 样 做 会 市 来 更 多 的 灵活 性 。 读 者 可 能 会 想 ， 我 们 不 必 从 native 代 码 中 返回 数 
组 ， 而 是 通过 Java 代 码 查 询 数 据 库 ， 碍 询 完 成 后 再 计算 距离 并 排序 。 这 种 想法 不 错 。 如 果 数 据 库 足 够 大 ， 以 至 于 使 用 数组 根本 无 
法 工作 ， 这 样 的 话 ， 从 native 代 码 中 返回 Cursor 融 是 最 好 的 解决 方案 ， 但 是 ， 从 native 代 码 返回 Cursor 是 相对 不 容易 实现 的 。 所 
玉 的 是 ,已 经 有 人 实现 了 上 述 功能 ， 读 者 可 以 查看 android-database-sqlcipher 的 源 代码 。 得 到 了 Cursor， 束 可 以 为 ListView 
使 用 CursorAdapter 适 配器 ， 这 样 程序 就 变 得 很 简单 了 。 


读者 还 应 该 知道 ， 可 以 通过 其 他 方式 避免 创建 自 定 义 功 能 。 可 以 事先 计算 所 需 的 值 ， 然 后 将 这 些 值 插入 数据 库 中 。 这 些 值 是 
否 够 用 主要 取决 于 应 用 程序 的 查询 类 型 。 


42.4 外 部 链接 


http://en.wikipedia.org/wiki/Haversine formula 
http:;//developer.android.com/reference/android/database/sglite/package-summary.html 
www.sglite.org/capi3.html 

www.movable-type.co.uk/scripts/latlong.html 

www.thismuchiknow.co.uk/?p- 71 


https://github.com/sglcipher/android-database-sqalcipher 


Hack 43 ”数据 库 批 处 理 


Android v2.1+ 


Android 应 用 程序 中 有 一 个 不 错 的 功能 是 : 可 以 将 数据 保存 在 数据 库 中 ， 然 后 使 用 CursorAdapter 将 其 显示 在 列表 中 。 如 果 
使 用 ContentProvider 处 理 数据 库 操作 ， 可 以 返回 一 个 Cursor， 当 数据 改变 时 ， 该 Cursor 会 随 之 更 新 。 这 意味 着 ， 如 果 一 切 正 
常 ， 开 上 有 者 可 以 专注 于 在 后 人 台 线 程 中 提供 修改 数据 库 表 中 的 信息 的 逻辑 ，Ul 就 会 被 自动 更 新 。 这 种 方法 的 问题 是 ， 如 果 执 行 了 
大 量 数据 库 操 作 ，Cursor 会 被 频繁 更 新 ， 这 样 会 使 UI 内 (flicker) 。 


在 这 个 Hack 里 ， 读 者 会 看 到 如 何 使 用 批量 处 理 来 解决 内 烁 的 问题 。 为 了 更 好 地 理解 这 个 问题 ， 我 们 提供 了 三 种 可 能 的 实 
现 ， 并 从 中 找 出 可 行 方案 : 


| 不 使 用 批 处 理 


` 使 用 批 处 理 
` 使 用 批 处 理 ， 并 且 使 用 SQLiteContentProvidet 类 


演示 程序 很 简单 ， 显 示 一 个 从 1 到 100 的 列表 。 当 用 尸 点 击 刷 新 按钮 后 ， 老 数字 会 被 删除 ， 新 数字 会 被 添加 。 为 了 实现 上 述 
功能 ,我们 将 为 下 面 的 四 种 控件 编码 : 


一 个 Activity， 用 于 显示 数字 

: 一 个 适配器 ， 用 于 创建 并 填充 ListView 中 的 视图 

- 一 个 ContentPtovider 用 于 处 理 数据 库 查询 

“ 一 个 Service， 用 于 通过 ContentProvider 更 新 数据 库 表 

可 以 在 图 43-1 中 看 到 应 用 程序 运行 效果 。 人 列表 中 每 行 会 在 左边 显示 数据 库 ID， 在 右边 显示 生成 的 数字 。 


可 以 想见 ， 这 三 种 实现 方案 的 大 部 分 代码 都 是 比较 简单 的 。 每 种 实现 方 
ContentProvider。 既 然 读者 都 能 看 懂 示 例 代 码 ， 这 里 ， 我 们 只 分 析 每 种 方 
和 ContentProvider 中 。 


Di 


都 会 有 各 自 的 Activity、Adapter、Service 和 
中 不 同 的 部 分 的 代码 ， 这 些 代码 主要 位 于 Service 


Di 
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这 是 最 简单 的 例子 。 在 Service 中 ， 只 有 需要 操作 数据 库 表 的 时 候 才 访问 ContentProvider。Service 的 代码 如 下 所 示 : 


public class NoBatchService extends IntentService { 





@Override 插入 新 数字 
protected void onHandleIntent (Intent intent) { 前 ， 先 删 之 
ContentResolver contentResolver = getContentResolver(); 六 的 数字 

contentResolver.delete( «| 


NoBatchNumbersContentProvider.CONTENT URI, 


null, null); 在 for 循环 中 ， 创 建 





for (int i = 1; i <= 100; i++) ( ContentValue, Jf 
ContentValues cv - new ContentValues(); 过 ContentResolver 
cv.put( -| dii ACE 
NoBatchNumbersContentProvider.COLUMN TEXT, "" + i); 


contentResolver.insert( 
NoBatchNumbersContentProvider.CONTENT URI, cv); 


a TAERA 3E. XAEXDJMRHJExRJJ;iAiERAd Refresh" T&THEAEREDLAAUPETRBUACE. MRR 
浴 动 起 来 会 很 困难 。 


之 所 以 出 现 上 述 情况 是 因为 每 次 通过 NoBatchNumbersCon-tentProvider 执 行 插入 或 删除 操作 时 ， 执 行 了 以 下 操作 : 


getContext().getContentResolver().notifyChange(uri, null); 


这 意味 着 ， 通 过 NoBatchNumbersContentProvider 的 query () 方法 检索 出 的 Cursor 会 被 更 新 ， 适 配器 会 令 ListView 上 自身 
也 友 生 刷新 。 


43.2 ”使 用 批 处 理 操作 


第 二 种 方法 是 使 用 批量 操作 。 在 ContentProvider 中 定义 了 如 下 方法 : 


public ContentProviderResult[] applyBatch( 
ArrayList«ContentProviderOperation» operations); 


这 种 方法 的 思路 是 创建 一 个 ContentProviderOperations 的 列表 ， 然 后 一 起 处 理 列 表 项 。 在 本 例 中 ，Service 的 代码 如 下 所 


A 


public class BatchService extends IntentService { 
private static final String TAG = 
BatchService.class.getCanonicalName(); 


QOverride 
protected void onHandleIntent(Intent intent) ( 
Builder builder - null; 创建 ContentPro- 
ContentResolver contentResolver - getContentResolver(); viderOperations 
ArrayList«ContentProviderOperation» operations - a4— 的 列表 
new ArrayList«ContentProviderOperation»(); 
—D builder - ContentProviderOperation 
.newDelete(BatchNumbersContentProvider.CONTENT. URI); 
operations.add(builder.build()); 


for (int 1 = 1; i <= 100; i++) 1 为 每 一 
ContentValues cv = new ContentValues(); 个 数字 
cv.put(NoBatchNumbersContentProvider.COLUMN TEXT, "" + i); 创建 一 
builder = ContentProviderOperation 个 插入 

使 用 Content- .newInsert(BatchNumbersContentProvider.CONTENT URI); < 操作 
ProviderOper- builder.withValues (cv); 

* E i [i la 
ations 的 构建 operations.add(builder.build()); & uU 3 


器 创建 删除 操 ) | 
作 ， 并 将 该 操 bro d 2 t i] FH apply- 


作 添 加 到 操作 contentResolver.applyBatch( 一 Batch() 方法 
列表 中 BatchNumbersContentProvider.AUTHORITY, operations); 
) catch (RemoteException e) ( 
Log.e(TAG, "Couldn't apply batch: " + e.getMessage()); 


) catch (OperationApplicationException e) ( 
Log.e(TAG, "Couldn't apply batch: " + e.getMessage()); 


如 果 读 者 测试 这 种 方法 ， 不 会 看 到 任何 不 同 之 处 : DJERISZURRERAGGESÉ. HtA? 


如 果 分 析 下 ContentProvider 的 实现 代码 ， 会 发 现 applyBatch () 方法 并 没有 什么 特别 之 处 ， 该 方法 只 是 循环 思 历 每 一 个 
操作 ， 并 调用 apply () 方法 ， 该 方法 最 终 会 调用 BatchNumbersContentProvider 类 中 的 insert () /delete () 方法 。 


这 听 起 来 让 入 很 篮 挫 ， 但 是 这 确 确 实 实 是 applyBatch () 方法 的 官方 文档 里 摘 述 的 (D143.515) : 


重 写 该 方法 以 处 理 批量 操作 请 求 ， 和 否则， 默认 实现 会 循环 遍历 各 个 操作 并 为 每 个 操作 调用 
apply (ContentProvider, Content-ProviderResult[], int) 方法 。 如 果 所 有 apply (ContentProvider, ContentProvider-Result[], int) 方 
法 调用 都 成 功 ， 就 会 返回 一 个 ContentProvidet-Result 类 型 的 数组 ， 该 数组 会 保存 各 个 操作 所 返回 的 数据 元 素 。 如 果 任 一 次 方法 调 


用 失败 ， 需 要 根据 不 同 的 实现 来 决定 其 他 方法 调用 是 否 有 效 。 C 


43.3 ”使 用 SQLiteContentProvider 执 行 批 处 理 操作 
读者 已 经 知道 使 用 批量 处 理 的 方式 是 解决 内 炸 问 题 的 合理 方案 ， 读 者 也 知道 需要 在 ContentProvider 的 实现 代码 中 对 
applyBatch () 方法 做 一 些 修改 才能 达到 目的 。 至 运 的 是 ， 有 人 已 经 车 开发 者 做 了 。 


在 Android 开 源 项 目 中 (Android Open Source Project， 简 称 AOSP) 有 一 个 名 为 SQLiteContentProvider 的 类 ， 这 个 类 
不 属于 SDK， 而 是 位 于 com.android.providers.calendar 中 。 对 于 本 例 ， 我 们 不 需要 继承 ContentProvider， 而 是 继承 
SQLiteContentProvider, 


service 的 代码 与 第 二 种 方法 基本 相同 。 接 下 来 分 析 SQLite-ContentProvider 的 applyBatch () 方法 : 


GOverride 
public ContentProviderResult[] applyBatch( 
ArrayList«ContentProviderOperation» operations) : m 
throws OperationApplicationException { 所 有 操作 者 
mDb = mOpenHelper.getWritableDatabase(); 在 数据 库 事 
mDb.beginTransactionWithListener(this); 务 中 执行 


Cry f 
mApplyingBatch.set (true); 
final int numOperations = operations.size(); 
final ContentProviderResult[] results = 
new ContentProviderResult[numOperations]; 


for (int i = 0; i < numOperations; i++) ( 
final ContentProviderOperation operation = operations.get(i); 
results[i] = operation.apply(this, results, i); " ; ur 
! [i] p pply ( ) 7 | 这 种 实现 
也 是 调用 


return results; 


mDb.setTransactionSuccessful(); um 结束 数据 库 事务 apply() 方法 


) finally ( l e : 
mApplyingBatch.set(false); onEndTransaction 负责 在 所 
mDb.endTransaction(); 有 操作 执行 完毕 后 ， 通 知 数 
onEndTransaction(); 据 发 生变 化 
) 


到 目前 为 止 ， 读 者 已 经 知道 每 个 操作 都 是 在 数据 库 事务 中 执行 ， 但 是 这 种 实现 方法 仍然 需要 为 每 个 操作 调用 apply () 75 
法 。 为 什么 不 会 在 每 次 insert () /delete () 方法 调用 时 得 到 通知 呢 ? 


要 正确 理解 这 种 方式 ， 需 要 分 析 SQLiteContentProvider 的 insert () 方法 的 实现 代码 : 


QGOverride 
public Uri insert(Uri uri, ContentValues values) { 检 
S 


PE 
Uri result = null; 和 
boolean applyingBatch = applyingBatch(); 4 行 批量 处 理 


if (!applyingBatch) ( 
mDb = mOpenHelper.getWritableDatabase(); 
mDb.beginTransactionWithListener(this); 
try ( 
result - insertInTransaction(uri, values); 
if (result l= null) ( 
mNotifyChange - true; 
) 
mDb.setTransactionSuccessful(); 
) finally { 
mDb.endTransaction(); 


j 如 果 在 批量 处 理 操作 中 ， 
onEndTransaction(); 调用 insertInTransaction() 


) else { 方法 


result = insertInTransaction(uri, values); 


1f (result !z null) { 


mNotifyChange - true; 十 一 一 如 果 插 入 了 数据 就 打 开 
) | d 
mNotifyChange 标记 ， 以 使 
onEndTransaction() 方法 知 
return result; iB dE us 4 Ie 





insertlnTransaction () 方法 的 逻辑 在 我 们 的 实现 方案 中 。 该 方法 与 其 他 方法 是 相同 的 ， 只 是 缺少 了 数据 变化 通知 的 逻 


如 果 运 行 这 个 实现 方案 ， 会 看 到 内 炬 的 现象 消失 了 ， 这 是 因为 只 有 所 有 操作 都 执行 完毕 ，Ul 才 会 被 刷新 。 


43.4 概要 


SQLiteContentProvider 类 不 属于 SDK 是 很 遗憾 的 。 如 果 ContentProvider 使 用 SQLite 数 据 库 存储 数据 ， 那 么 就 试 试 
SQLiteContentProvider 吧 ， 它 会 使 UI 响应 会 更 灵敏 ， 在 单独 事务 中 执行 操作 也 会 让 程序 运行 更 快 。 


43.5 ”外 部 链接 


http://developer.android.com/reference/android/content/ContentProvider.html 


http://stackoverflow.com/questions/9801304/android-contentprovider-calls-bursts-of-setnotificationuri-to- 


cursoradapter-wh 


第 11 晶 ”避免 代码 碎片 化 


对 于 Android 开 友 者 来 说 ， 代 码 碎 片 化 是 一 个 严重 的 问题 。 本 章 ， 我 们 分 析 一 些 技巧 ， 通 过 这 些 技巧 可 以 完成 特定 任务 并 同 


后 兼容 旧版 本 。 


Hack 44 ”处 理 烛 灯 模式 


Android v1.6- 


在 Android 早 期 ， 系 统 在 屏幕 顶部 显示 一 个 状态 栏 (Status Bar) ， 但 是 在 Android 的 Honeycomb 版 本 上 ， 状 态 栏 移 到 了 
屏幕 底部 。 


类 似 游 戏 或 者 图 片 查 看 器 之 类 的 应 用 程序 需要 吸引 用 户 注意 力 ， 因 此 通常 都 会 全 屏 显 示 。 例 如 ， 在 默认 的 相册 应 用 程序 中 ， 
当 用 户 点 击 一 幅 图 片 ， 这 幅 图 片 会 覆盖 其 他 内 容 进 而 占据 整个 屏幕 。 

假设 开 友 者 想 在 应 用 程序 中 提供 上 述 特性 ， 并 且 该 特性 需要 兼容 Android 的 每 个 版 本 。 在 这 个 Hack 里 ， 我 们 会 创建 一 个 简 
单 的 示例 程序 ， 这 个 程序 会 显示 一 个 红色 背景 ， 点 击 该 背景 后 ， 应 用 程序 便 进入 熄灯 模式 !1] (lights-out mode) 。 我 们 会 分 别 


处 理 Android 2.x 和 3.x 版 本 ， 最终， 我 们 会 把 两 个 版 本 的 实现 代码 集成 到 一 份 代 码 中 。 


[1] 在 特定 情况 下 ， 通 过 减少 或 者 隐藏 导航 栏 、 动 作 栏 以 及 系统 UI 等 控件 ， 为 用 户 提 供 全 屏 无 干扰 的 视觉 体验 就 是 熄灯 模式 。 熄 
灯 模 去 可 以 保证 用 户 更 好 地 关注 屏幕 内 容 。 如 果 用 户 需要 操作 内 容 ， 可 以 通过 触摸 屏幕 等 方式 退出 熄灯 模式 。 





译 者 注 


44.1 Android 2.x 


首先 创建 应 用 程序 Android 2.x 版 本 的 代码 。 在 Android 2.x 中 有 全 屏 模式 的 概念 。 全 屏 模式 的 思路 是 允许 应 用 程序 窗口 使 用 
整个 显示 区 域 。 


我 们 还 会 天 注 另 一 个 概念 : 应 用 程序 标题 。 应 用 程序 标题 是 在 屏幕 上 方 显示 的 灰色 条 。 


接 下 来 看 看 代码 是 如 何 实现 的 : 


public void onCreate(Bundle savedlInstanceState) ( 


super.onCreate(savedInstanceState); 





requestWindowFeature (Window.FEATURE NO TITLE); «—Q tem a 
setContentView(R.layout.main); 
mContentView - findViewById(R.id.content); < 4B : 
i 得 到 界面 
mContentView.setOnClickListener(new OnClickListener() ( H3 5l 用 
QGOverride 
ublic void onClick(View v) ( 

5 各 根据 成 只 变量 切 
Window w = getWindow(); 换 状 态 
if(mUseFullscreen) ( 1 

w.addFlags( 
WindowManager.LayoutParams.FLAG FULLSCREEN); 
w.clearFlags( 
WindowManager.LayoutParams.FLAG FORCE NOT FULLSCREEN); 
) else { 
w.addFlags( 
WindowManager.LayoutParams.FLAG FORCE NOT FULLSCREEN); 
w.clearFlags( 
WindowManager.LayoutParams.FLAG FULLSCREEN); 
} 
mUseFullscreen = !mUseFullscreen; 
} 
2r 
} 
RE—EHTA. BRAD., FNR ERSRCEWIRisetContentView () 方法 之 前 完成 。 然 后 ， 调 用 常用 的 


setContentView () 方法 得 到 视图 根 元 素 的 引用 @@。 根 元 素 用 于 全 屏 模 式 的 开 闭 切换 。 


最 后 一 部 分 代码 表示 全 屏 模 式 如 何 生 效 。 读 者 可 以 在 @ 中 看 到 如 何 通 


44.2 Android 3.x 


frAndroid 3.x 中 ， 
栏 却 被 移 到 屏幕 底部 


Android 3.x 版 本 的 一 个 重要 变化 是 没有 物理 按键 ， 按 键 都 放置 在 状态 栏 中 ， 因 此 不 能 据 痉 状态 桩 


IE, 


代码 如 下 所 示 : 


过 成 员 变 量 切 换 状 态 。 


一 些 概念 与 Android 2.x 有 些 区 别 。 标 题 栏 被 动作 栏 (Action Bar) 蔡 代 ， 仍 然 位 于 屏幕 上 方 ， 但 是 状态 


， 但 是 可 以 将 其 暗 化 处 


aOverride 
public void onCreate(Bundle savedInstanceState) ( 


super.onCreate(savedInstanceState); em 
gre 





setContentView(R.layout.main); 
mContentView = findViewByIG(R.id.content); q 


mContentView.setOnSystemUiVisibilityChangeListener( «1-4 s iis ct 
new OnSystemUiVisibilityChangeListener() ( pet JEK ox FF a 
public void onSystemUiVisibilityChange(int visibility) ( @ MEE 
ActionBar actionBar - getActionBar(); 
if (actionBar !- null) ( 
mContentView.setSystemUiVisibility(visibility); 是 否 可 视 的 
if (visibility == View.STATUS BAR VISIBLE) { < 参数 
actionBar.show(); 
) else ( 


actionBar.hide(); 


n 设置 点 击 监 


ng 
mContentView.setOnClickListener(new OnClickListener() { < 二 一 一 UT di 
public void onClick(View v) ( 


if (mContentView.getSystemUiVisibility() == 
View.STATUS BAR VISIBLE) { 


mContentView.setSystemUiVisibility(View.STATUS BAR HIDDEN); 


} else ( 


mContentView.setSystemUiVisibility (View.STATUS BAR VISIBLE); 


与 上 节 的 代码 很 相似 ， 首 先 获取 视图 根 节点 的 引用 @。 在 Honeycomb 版 本 中 ， 视 图 提供 了 一 个 名 为 
setOnSystemUiVisibility ChangeListener () 的 新 方法 。 提 供 该 方法 的 目的 是 为 了 在 系统 栏 的 可 视 状 态 改 变 时 可 以 接受 回调 。 
通过 上 述 方法 ， 根 据 visibility 参 数 @ 隐 藏 或 者 显示 动作 栏 ， 这 部 分 代码 见 @®。 在 @@ 中 ， 为 根 视图 设置 点 击 监听 器 ， 用 于 切换 系统 
UI 的 可 视 性 ， 也 即 开启 或 关闭 熄灯 模式 。 


44.3 ”在 一 个 Activity 中 整合 两 种 实现 


上 文 已 经 演示 了 如 何在 不 同 Android 版 本 中 处 理 两 种 情况 ， 但 是 ， 如 果 能 够 互相 兼容 束 好 了 。 可 以 创建 一 个 Activity， 通 过 


-NN 


这 个 Activity 检 查 设备 运行 的 Android 版 本 ， 然 后 根据 检查 结果 选择 运行 相应 版 本 的 Activity。 实 现代 码 如 下 所 示 : 


Class»?» activity - null; 


Tr d Build.VERSION.SDK INT >= Build.VERSION_CODES.HONEYCOMB ) { i x . 
K; fr Android 


activity = MainActivity2X.class; 
Lr; = 
) else ( Q "^ 
activity = MainActivity3X.class; —- m 
/ : Q9 3h 
} * * 
Activity 


sStartActivity(new Intent (this, activity)); 
LTinis5hil: 


通过 Build 类 检查 Android 版 本 。Build 类 中 定义 了 一 个 内 部 类 VERSION_CODES@， 通 过 该 内 部 类 ， 可 以 检查 设备 运行 的 
Android 版 本 。 基 于 检查 结果 ， 分 别 局 动 不 同 的 Activity@)。 


44.4 ”概要 


读者 会 友 现 这 个 Hack 完 成 的 功能 都 可 以 使 用 style 实 现 。 如 果 读 者 不 想 动 态 广 持 这 项 特性 ， 那 么 使 用 style 也 是 可 以 的 。 


读者 应 该 意识 到 ， 隐 藏 状态 栏 会 导致 用 户 无 法 看 到 通知 ， 这 样 用 户 有 可 能 会 天 闭 应 用 程序 去 查看 当前 有 什么 情况 友 生 。 此 
外 ， 在 Android 中 使 用 熄灯 模式 ， 是 让 用 户 “ 泡 ”在 应 用 程序 中 的 好 办 法 。 


44.5 ”外 部 链接 


http:;//developer.android.com/reference/android/view/Window-Manager.html 


http:;//developer.android.com/reference/android/app/ActionBar.html 


Hack45 在 旧版 本 上 使 用 新 AP| 


Android v1.0 十 


每 当 Android 有 新 版 本 友 布 时 ， 新 的 API 束 会 被 引入 。 多 数 情 况 下 ， 这 可 以 为 开 友 者 提供 更 多 方式 来 展示 内 容 或 者 为 设备 提 
供 更 多 功能 。 通 第 ， 当 用 户 在 设备 上 运行 新 版 本 的 Android 时 ， 他 们 都 想 体验 到 新 API 的 优势 ， 但 是 ， 开 上 友 者 仍然 需要 关注 那些 
使 用 旧版 本 的 用 尸 ， 这 样 老 用 户 才 会 继续 使 用 你 的 应 用 程序 。 有 没有 办 法 让 应 用 程序 既 可 以 使 用 新 AP1l 又 能 向 后 兼容 呢 ? 


在 这 个 Hack 里 ， 我 们 会 看 到 如 何在 应 用 程序 中 使 用 Android 的 新 API 并 能 够 运行 于 老 设 备 。 我 们 会 创建 一 个 演示 程序 用 于 显 
示 程 序 的 启动 次 数 ， 启 动 次 数 会 通过 SharedPreferences 类 持久 化 。 在 演示 程序 中 ， 我 们 会 用 到 不 同 版 本 的 Android 中 的 两 个 
API。 第 一 个 APl 是 Android v9 中 为 SharedPreferences.Editor 类 新 添加 的 apply () 方法 。 第 二 个 APl 是 在 Android API Level 8 
中 引入 的 ， 用 于 在 manifest 文 件 中 声明 是 否 允 许 将 应 用 程序 安装 在 SD 卡 上 。 使 用 Android API Level 8 以 及 以 上 版 本 的 用 户 可 以 
在 SD 卡 上 安 半 应 用 程序 ， 人 否则 便 会 把 应 用 程序 安 妆 人 在 设备 的 内 部 仓储 器 上 。 


45.1 使 用 apply () &ifVcommit () 


要 操作 SharedPreferences 类 ， 需 要 获取 一 个 Editor 类 ， 然 后 调用 该 类 提供 的 方法 来 修改 SharedPreferences 的 值 。 所 有 相 
天 修改 都 完成 时 ， 需 要 调用 commit () 方法 。 


从 Android v9 版 本 开始 ，SharedPreferences.Editor 提 供 了 apply() 方法 用 于 车 代 commit () 方法 。 这 两 个 方法 有 什么 
不 同 呢 ? 官方 文档 的 解释 如 下 所 示 (145.47) : 


"commit () 方法 会 同步 地 将 偏好 值 (Preference) 直接 写 入 持久 化 存储 设备 ， 与 其 不 同 的 是 ，apply O 方法 会 立即 把 修改 
内 容 提 交 到 SharedPtefetences 内 存 缓存 中 ， 然 后 开始 异步 地 将 修改 提交 到 存储 设备 上 ， 在 这 个 过 程 中 ， 开 发 者 不 会 察觉 到 任何 错 
误 问 题 。 


简 言 之 ， 如 果 不 需要 用 到 操作 的 返回 值 ， 开 久 者 融 应 该 用 apply () 方法 代 蔡 commit () 方法 。 


因为 需要 演示 程序 具有 较 快 的 啊 应 速度 ， 因 此 我 们 使 用 apply () 方法 以 避免 在 UI 线程 中 执行 向 磁盘 提交 数据 等 耗 时 操作 。 
要 满足 上 述 要 求 ， 可 以 借用 Brad Fitzpatrick 的 代码 ， 该 代码 在 apply () 方法 可 用 时 便 调 用 apply () 方法 ， 否 则 残 调 用 
commit () 方法 。Brad Fitzpatrick 是 Android 团 队 的 一 名 开发 者 。 


首先 看 看 Activity 的 实现 代码 : 


public class MainActivity extends Activity ( 


private static final String PREFS NAME - "main activity prefs"; 
private static final String TIMES OPENED KEY = "times opened key"; 
private static final String TIMES OPENED FMT = "Times opened: £d"; 
private TextView mTextView; 
private int mTimesOpened; ix 置 Con- 
l tentView, 
QOverride 
public void onCreate(Bundle savedInstanceState) ( 9 jk HX 
super.onCreate(savedInstanceState); TextView 
setContentView(R.layout.main); < 二 一 一 的 引用 
mTextView = (TextView) findViewById(R.id.times. opened); 
} 
@Override 
protected void onResume() { 


super.onResume(); 


SharedPreferences prefs - getSharedPreferences(PREFS NAME, 0); 


]H 充 Text- 一 [> mTimesOpened = prefs.getInt(TIMES OPENED KEY, 1); 

MEAM r2] mTextView.setText(String.format(TIMES OPENED FMT, mTimesOpened)); 
} 
QOverride 
protected void onPause() ( 


RÉI | 

super.onPause(); inten 
» " vi> 米 
X MF Shared- | | | 动 次 数 
通过 Shared Editor editor = getSharedPreferences(PREFS NAME, 0).edit(); 的 什 
Preferences- editor.putInt(TIMES OPENED KEY, mTimesOpened + 1); - 
Compat 类 调 o> SharedPreferencesCompat .apply (editor); 
用 apply O 7 } 





法 


首先 设置 ContentView 并 获取 TextView 的 引用 ， 该 TextView 用 于 显示 应 用 程序 启动 次 数 。 在 onResume () 方法 中 ， 我 


们 从 SharedPreferences 中 获取 之 前 持久 化 的 信息 ， 然 后 以 该 信息 填充 TextView@。 最 后 ， 在 onPause () 方法 中 ， 我 们 从 
SharedPreferences 得 到 一 个 Editor， 然 后 增加 启动 次 数 @。 注 意 ， 并 没有 在 代码 中 直接 调用 apply () 方法 ， 而 是 通过 
SharedPre-ferencesCompat 类 调用 了 该 万 法 @。 


接 下 来 分 析 SharedPreferencesCompat 类 ,分 析 其 实现 逻辑 : 


public class SharedPreferencesCompat { 
private static final Method sApplyMethod = findApplyMethod(); 


private static Method findApplyMethod() { «4 检查 apply() 
ur | 方法 是 否 可 
Class cls = SharedPreferences.Editor.class; © 


return cls.getMethod ("apply"); 
} catch (NoSuchMethodException unused) { 
// fall through 


} 
return null; 
} 
public static void apply(SharedPreferences.Editor editor) { 
if (sApplyMethod !- null) { 
try ( . 、 
sApplyMethod.invoke (editor); -真正 调用 
return; Editor 的 
) catch (InvocationTargetException unused) ( @apply0 方 


// fall through 
) catch (IllegalAccessException unused) { 
// fall through 


法 


} 


editor.commit(); -© 否则 调用 commit() 
) 


SharedPreferencesCompat 类 通过 Java 反 射 机 制 检 查 Shared-Preferences.Editor 类 的 apply () 方法 是 否 可 用 @。 如 果 该 
方法 可 用 ， 融 将 其 他 到 一 个 静态 变量 中 。 当 调用 apply () 方法 时 ， 便 通过 传 入 的 Editor 参 数 真 正 触 友 设 参 数 的 apply () 方法 
@。 如 果 上 述 调用 失败 ， 融 调用 commit () 方法 @。 


45.2. ”将 应 用 程序 安 丢 到 ?3D 下 中 
在 上 一 节 中 ， 我 们 开发 了 一 个 显示 启动 次 数 的 应 用 程序 。 现 在 ， 我 们 为 其 添加 一 些 新 内 容 ， 使 其 可 以 安装 在 SD 卡 上 而 不 是 
内 部 存储 器 上 。 


MAndroid v8 开 始 ， 你 可 以 向 AndroidManifest 中 添加 一 个 名 为 android: installLocation 的 属性 。 要 理解 这 个 属性 的 作 
用 ， 可 以 参考 开 友 文档 的 解释 (145.515) : 


“这 是 一 个 可 选 特性 ， 你 可 以 通过 在 Manifest 文 件 中 声明 android: installLocation 属 性 来 使 用 这 项 特性 。 如 果 你 没有 声明 这 个 
属性 ， 应 用 程序 就 会 被 安装 到 内 部 存储 器 上 ， 并 且 你 不 能 把 它 移 到 外 部 存储 器 中 。 


要 使 用 上 述 属 性 ， 我 们 需要 在 AndroidManifest.Xxml| 文 件 中 修改 下 面 几 个 代码 : 


<?xml version="1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.manning.androidhacks.hack045" 


Long x i 
android:versionCode="1" iz ñ. android:install 


android:versionName-"1.0" Location Ji TE 1E. 7g 
android:installLocation-"preferExternal"-» <4—  preferExternal 
«uses-sdk android:minSdkVersion-"8"/» < e it E minSdkVersion 
属性 值 为 8 


我 们 将 android: installLocation 属 性 值 设 为 preferExternal)， 有 SD 卡 的 时 候 ， 应 用 程序 就 会 安 灸 到 SD 卡 上 。 要 使 用 这 个 
寺 性 ， 需 要 将 minSdkVersion 属 性 值 设置 为 8@3。 在 代码 中 指定 上 述 内 容 ， 用 户 就 无 法 在 APl 8 以 下 级 别 的 Android 上 按照 该 应 用 
程序 。 要 解决 这 个 问题 ， 可 以 将 最 后 一 行 做 以 下 修改 ,源码 如 下 所 示 : 


«uses-sdk android:minSdkVersion="4" android:targetSdkVersion-"8" /> 
上 述 修改 的 意思 是 : “使 用 API Level 8 的 JAR 包 编译 ， 并 且 使 用 了 新 的 API1， 但 是 允许 应 用 程序 安 半 在 API Level 4 及 以 上 的 


设备 中 。” 尽 管 上 述 修改 可 以 起 到 作用 ， 但 是 有 些 事 项 需要 注意 。 强 行 在 高 版 本 API Level 上 编译 ， 会 导致 类 和 方法 不 能 同 后 兼 
容 。 举 个 例子 ， 如 果 开 友 者 想 在 当前 运行 版 本 上 调用 一 个 该 版 本 中 没有 提供 的 万 法 ， 会 出 现 java.lang.VerifyError 寞 单 。 


45.3 ”概要 


使 用 类 似 sSharedPreferencesCompat 这 样 的 兼容 类 是 Androld 开 上 友 者 单 用 的 工程 实践 。 我 建议 ， 在 开 友 过 程 中 ， 使 用 最 旧 
版 本 的 设备 以 避免 出 现 不 兼容 的 隐患 。 当 开发 者 发 现 有 比较 新 的 AP| 无 法 在 这 种 设备 上 使 用 时 ， 就 创建 这 样 的 兼容 类 ， 并 选择 如 
何 处 理 这 种 新 APl。 


另外 还 要 记 住 ，targetSdkVersion 是 既 可 以 使 用 Android 新 特性 ， 又 不 会 放弃 使 用 旧版 本 系统 的 老 用 户 的 好 方法 。 


45.4 外 部 链接 


http://android-developers.blogspot.com/2010/07/how-to-have-your-cupcake-and-eat-it-too.html 
http:;//code.google.com/p/zippy-android/source/browse/trunk/examples/SharedPreferencesCompat.java 
http:;//developer.android.com/reference/android/content/SharedPreferences.Editor.htmlapply() 
http://developer.android.com/guide/appendix/install-location.html 
http:;//developer.android.com/reference/android/accounts/AccountManager.html 


http://developer.android.com/training/search/backward-compat.html 


Hack46 ”向 后 兼容 的 通知 


Android v1.6- 


Android 的 Jelly Bean 版 本 友 布 时 引入 了 新 的 通知 (noti.cation) API。 通 过 新 AP1， 可 以 为 通知 添加 动作 。 通 过 这 些 动 作 ， 
可 以 在 不 需要 进入 应 用 程序 的 情况 下 ， 对 通知 做 出 响应 。 读 者 可 以 在 图 46-1 中 看 到 示例 程序 。 未 接 来 电 的 通知 可 以 为 用 尸 提 供 
两 种 动作 : 回 拨 或 者 向 来 电 方 友 送 短信 。 


Aa Call back Message 


24 new messages 


Save [ne Hamm 


图 46-1 Jelly Bean 中 的 通知 





如 果 应 用 程序 需要 使 用 通知 ， 那 么 为 通知 添加 动作 可 以 大 大 提升 用 户 体验 。 那 么 如 何 使 用 新 的 通知 API1， 并 做 到 加 后 兼容 
Ue? 在 这 个 Hack 里 ， 我 们 会 看 到 如 何 通 过 Android 支 持 库 (support library) 达到 这 一 目的 。 


为 了 理解 新 API 的 工作 原理 ,我们 创建 一 个 演示 程序 ， 用 于 模拟 短信 应 用 程序 。 因 为 需要 应 用 程序 向 后 兼容 ， 我 们 会 提供 两 
种 处 理 流程 种 是 为 通知 添加 动作 ， 另 一 种 不 添加 动作 。 为 了 直观 表达 ， 读 者 可 以 看 看 没有 使 用 新 的 通知 API 时 ， 在 
Android v2.3.7 设 备 上 的 执行 流程 〈( 见 图 46-2) ， 也 可 以 看 看 企 Android v4.1.2 设 备 上 的 执行 流程 ( 见 图 46-3) 。 
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图 46-2 Android 2.3.7 版 
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USB connected 


| "IB Dy 


Ihis i5 the msg titie 1 Lorem ipsum dolor sit amet, consectetur adipiscing 
ntent meii Ul eu fermentum metus. Quisque facilisis 
utum massa, vel sodales ligula lobortis sed 
Pellentesque vulputate tortor nón quam venenatis 
pt Instique arcu elementum. Aliquam massa felis 
IUGG- cagittie ac. odalec.ac fale. Aenean 


Sollicitudin commodo nibh nec tempor. Curabitur 


>> Reply " Delete 


` ulputate laoreet sem, ut consequat nunc cursus 
USB debugging connected eu. Aliquam bibendum, enim nec sollicitudin 
h to disati 5 GEDUGGIM honcus, libero est feugiat tellus, sed laoreet lectus 
wque el nulla Quisque gravida porttitor kacma 
Integer sit amet odio eu nulla sollicitudin auctor 
uis Suscipit lacus in augue pellentesque nec 
'orrvalls eros tempor. Sed lacinia magna eget 
orem fringilla sodales. Phasellus condimentum, 
urpis at sollicitudin ultrices, nunc lectus laoreet 
tellus, m dictum misi est eget tortor, Suspendisse 
ehicula purus condimentum massa interdum 
enenaus in at justo. Donec rhoncus faucibus 
incdunt 
Aarh iiinft riaaef erdie Drun weeti hb rn 


Delete Reply 


图 40-3 Android 4.1.24 


从 图 46-2 中 可 以 看 出 ， 在 不 使 用 新 API 的 情况 下 ， 用 户 需要 进入 应 用 程序 。 在 使 用 新 API 的 情况 下 ， 用 户 不 必 进 入 应 用 程序 
束 可 以 删除 短信 ， 也 不 需要 通过 接收 短信 的 Activity 束 可 以 直接 回复 短信 。 


接 下 来 ,分 析 如 何 创建 上 述 应 用 程序 。 需 要 创建 三 个 Activity: 





: MainActivity 显示 一 个 按钮 ， 用 于 司 动 通知 。 








: MsgActivity 显示 和 短信， 并 且 有 Delete (删除 ) 和 Reply (回复 ) 按钮 。 
: ReplyActivity 显示 回复 界面 上 的 EditText 以 及 Discard (取消 ) 和 Send (发 送 ) 按钮 。 


上 述 Activity 中 并 没有 什么 特殊 代码 。 读 者 可 以 在 本 书 的 示例 代码 中 看 到 这 些 代码 。 


要 处 理 通 知 的 所 有 点 击 事 件 ， 需 要 使 用 Pendinglntent。Pending-intent 与 Intent 类 的 最 大 区 别 是 ， 前 者 用 于 延迟 执行 。 请 
看 开 友 文档 里 的 解释 (1146.25) : 


通过 向 其 他 应 用 程序 传送 一 个 PendingIntent， 开 发 者 可 以 为 该 应 用 程序 赋予 执行 指定 操作 的 权限 ， 这 样 其 他 应 用 程序 就 像 
是 你 自己 的 一 样 (具有 相同 的 权限 和 身份 信息 ) 。 就 PendingIntent 本 身 而 言 ， 开 发 者 需要 注意 构建 PendingIntent 的 方式 : 
对 于 基本 的 Intent， 会 显 式 指定 某 个 自己 的 组 件 (component) ， 以 确保 其 最 终 能 够 发 送 到 指定 的 目的 地 ， 而 不 会 发 送 到 其 他 地 


» 


方 。 


使 用 Pendinglntent 的 局 限 是 ， 开 发 者 无 法 做 出 类 似 “ 运 行 这 几 行 代码 ”这 样 的 操作 ， 只 能 局 动 一 个 Activity、service 或 者 


BroadcastReceiver, 





fEzmDEERCR, ARERI E 种 操作 不 需要 显示 Ul 界 面 (WR HB. AGXxB) ， 另 一 种 操作 需要 显 
示 U| 界 面 WA., PERE) 。 不 需要 显示 Ul 界 面 的 操作 可 以 用 后 台 逻 辑 实现 ， 因 此 我 们 创建 一 个 名 为 Msgservice 的 服务 。 


我 们 还 会 创建 一 个 名 为 NotificationHelper 的 静态 类 ， 用 于 实现 所 有 处 理 通 知 的 逻辑 以 及 Pendinglntent 的 创建 ， 源 码 如 下 
所 示 : 


public class NotificationHelper { 


public static void showMsgNotification(Context ctx) ( 4 由 MainAc- 
final NotificationManager mgr; tivity Js] 用 ， 
mgr = (NotificationManager) ctx 以 显示 通知 


.getSystemService(Context.NOTIFICATION SERVICE); 


NotificationCompat.Builder builder - 
new NotificationCompat.Builder( 
ctx).setSmalllIcon(android.R.drawable.sym def app icon) 
.SetTicker("New msg!").setContentTitle("This is the msg title") 
.SetContentText("content...") 
.SsetContentIntent(getPendingIntent(ctx)); 


builder.addAction(android.R.drawable.ic. menu. send, 
Cctx.getString(R.string.activity msg button reply), 添加 回 
getReplyPendingIntent (ctx)); uin 
复 动作 


builder.addAction(android.R.drawable.ic. menu delete, 
Cctx.getString(R.string.activity msg button delete), 
getDeletePendingIntent(ctx)); 


mgr.notify(R.id.activity main receive msg, builder.build()); 


) 


private static PendingIntent getDeletePendingIntent(Context ctx) { 
Intent intent - new Intent(ctx, MsgService.class); < 一 与 删除 短信 相关 的 
intent.setAction(MsgService.MSG DELETE); 
intent.setFlags(Intent.FLAG ACTIVITY CLEAR TOP); 
return PendingIntent.getService(ctx, 0, intent, 0); 到 MsgService 


PendingIntent 会 用 


private static PendingIntent getReplyPendingIntent(Context ctx) ( 
meent intent = new Intent (ctx, ReplyActivity.class); 与 回复 短信 相关 的 
intent.setFlags(Intent.FLAG ACTIVITY CLEAR TOP); . 3. 
i i PendingIntent 会 用 
return PendingIntent.getActivity(ctx, 0, intent, 0); 
) 到 Reply Activity 


private static PendingIntent getPendingIntent(Context ctx) ( 
Intent intent - new Intent(ctx, MsgActivity.class); <— 点 击 通知 时 ， 会 
intent.setFlags(Intent.FLAG ACTIVITY CLEAR TOP); 
return PendingIntent.getActivity(ctx, 0, intent, 0); 


通过 MsgActivity 





i 显示 短信 
public static void dismissMsgNotification(Context ctx) { 
final NotificationManager mgr; 取消 通知 的 
mgr = (NotificationManager) ctx sd 
辅助 方法 


.getSystemService(Context.NOTIFICATION SERVICE); 
mgr.cancel(R.id.activity main receive msg); 


通过 NotificationHelper 类 ， 可 以 处 理 所 有 与 通知 相关 的 操作 。 现 在 ， 我 们 来 分 析 MsgService 的 一 部 分 代码 。 因 为 
MsgService 继 承 自 IntentService， 其 onHandlelntent () 方法 的 源码 如 下 所 示 : 


QGOverride 
protected void onHandlelIntent(Intent intent) ( 
if ( MSG RECEIVE.equals(intent.getAction()) ) ( 
handleMsgReceive(); 
) else if ( MSG DELETE.equals(intent.getAction()) ) { 
handleMsgDelete(); 
) else if ( MSG REPLY.equals(intent.getAction()) ) ( 
handleMsgReply(intent.getStringExtra(MSG REPLY KEY)); 


对 应 通知 的 每 个 可 能 动作 ， 我 们 都 会 提供 一 个 方法 。 为 了 简单 起 见 ， 先 分 析 handleMsgDelete () 方法 : 


D E ER Rd fri m A E B 


private void handleMsgDelete() { 


44 建 日 志 
Log.d(TAG, "Removing msg..."); 4 : AUN 
NotificationHelper.dismissMsgNotification(this); «A 
@ 关 闭 通知 
在 完整 的 实现 代码 中 ， 我 们 会 提供 一 些 后 台 逻 辑 来 删除 短信 ， 而 非 创 建 日 志 @。 删 除 消息 后 ， 需 要 通过 NotificationHelper 
ASTRA. 


我 们 已 经 知道 如 何 创 建 向 后 兼容 的 通知 ， 并 且 知 道 如 何 使 用 Pendinglntent 处 理 不 同 的 点 击 操作 。 那 么 ， 当 点 击 
MsgActivity 的 删除 按钮 时 ， 如 何 处 理 ? 秘诀 就 是 让 MsgService 全 权 处 理 。 举 例 说 明 ，MsgActivity 中 的 删除 按钮 的 点 击 事件 处 
JERS: 

public void onDeleteClick(View v) { 
Intent intent - new Intent(this, MsgService.class); 
intent.setAction(MsgService.MSG DELETE); 


StartService(intent);:; 
finish(); 


可 以 看 到 ， 所 有 逻辑 都 在 服务 中 处 理 。 


46.1 概要 


新 的 通知 APl 是 很 棒 的 。 可 以 在 通知 中 人 处理 指 定 的 动作 ， 这 样 便 为 用 尸 提供 了 新 的 操作 体验 。 此 外 ， 通 过 支持 库 ， 可 以 确保 
“会 放 工 使 用 旧版 本 的 用 己 。 


46.2 ”外 部 链接 


http://developer.android.com/tools/extras/support-library.html 
http:;//developer.android.com/reference/android/app/Pending-Intent.html 


http:;//developer.android.com/reference/android/app/Intent-Service.html 


Hack47 ”使 用 Fragment 创 建 Tab 


Android v1.0 十 


如 果 读 者 在 Android 平 台 上 做 过 一 段 时 间 的 开发 工作 ， 那 么 很 可 能 用 过 TabActivity 类 。 该 类 允许 开发 者 在 应 用 程序 中 创建 
Tab， 这 样 用 户 就 可 以 通过 点 击 Tab 按 钮 在 不 同 Activity 之 间 切 换 。TabActivity 类 的 最 大 问题 是 ， 开 发 者 在 试图 定制 其 外 观 时 ， 
会 遇 到 很 多 问题 ， 而 且 该 类 在 Fragment 发 布 后 已 经 废弃 了 。 


尽管 Android SDK 提 供 了 TabHost 和 TabWidget 等 类 用 于 处 理 Tab， 但 是 使 用 自己 的 实现 方案 可 以 更 灵活 控制 应 用 程序 。 在 
这 个 Hack 里 ,我 会 向 读者 展示 如 何 吉 免 使 用 TabActivity 类 ， 而 是 使 用 Fragment 创 建 的 、 带 有 Tab 的 应 用 程序 。 我 们 会 创建 一 个 
演示 程序 ， 用 于 在 不 同 Tab 中 显示 不 同 颜色 。 最 终 效 果 如 图 47-1 所 示 。 
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图 47-1 á x XL Tab 


47.1 ”创建 自 定 义 Tab 的 UI 界面 


首先 ， 需 要 为 Tab 创 建 UI 界 面 。 为 此 ， 需 要 为 Tab 创 建 自 定 义 XML 布 局 文件 。 使 用 XML 设 计 Tab 界 面 的 好 处 是 ， 开 友 者 有 机 
会 以 自己 喜欢 的 方式 定位 和 调整 空间 的 大 小 。 对 于 本 例 ， 我 们 创建 一 个 LinearLayout， 并 在 其 中 显示 几 个 按钮 。 XML 文件 如 下 
所 示 : 


«?xml version-"1.0" encoding="utf-8"?> 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"horizontal" 
android:background-"Gnull"» 


«Button android:id-"G-«-id/tab red" 
android:layout height-"wrap content" 
android:layout width-"Odp" 
android:layout weight-"l]" 
android:text-"Red" /» 


«Button android:id-"QG-«-id/tab green" 
android:layout height-2"wrap content" 
android:layout width-"Odp" 
android:layout weight-"1" 
android:text-"Green" /» 


«Button android:id-"QG«id/tab blue" 
android:layout height-2"wrap content" 
android:layout width-"Odp" 
android:layout weight-"1" 
android:text-"Blue" /> 

«/LinearLayout» 


47.2 在 Activity 中 放置 Tab 


为 了 避免 在 每 个 Activity 中 都 复制 /粘贴 Tab 的 布局 文件 ， 我 们 使 用 include 标 和 釜 。MainActivity 的 XML 布局 文件 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?-» 

«FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 


android:layout height-"fill parent"-» Fragment 
«FrameLayout android:id-"Q«id/main fragment container" < 一 的 容 符 


android:layout width-"fill. parent" 
android:layout height-"fill parent"/» 


将 Tab 的 布局 文件 

«include layout-"Glayout/tabs" "f 的 布局 文件 
android:layout width-"fill parent" 添加 到 Activity 的 
android:layout height-2"wrap content"/» «— 视图 中 


«/FrameLayout» 


中 的 FrameLayout 作 为 Fragment 的 容器 。 每 当 用 户 点 击 某 个 Tab 时 ， 当 前 Activity 负 责 将 相应 的 Fragment 显 示 到 该 Tab 
中 。 在 @ 中 ， 使 用 include 标 签 将 Tab 的 布局 文件 添加 到 Activity 的 视图 中 。 注 意 ， 我 们 将 include 标 签 放 置 在 底部 ， 是 为 了 让 其 
显示 在 Fragment 容 器 的 上 方 。 


人 至此， 已 经 完成 了 Ul 界 面 ， 现 在 分 析 Activity 的 处 理 逻 辑 : 


public class MainActivity extends FragmentActivity ( 二 使 用 Frag- 
@Override ment 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 为 按钮 设置 点 击 监 听 
setContentView(R.layout.main); 
售 ， 进 而 通过 新 建 一 
findViewById(R.id.tab red).setOnClickListener( 个 Fragment 实例 调用 
new OnClickListener() ( < switchFragment() Jr 
QGOverride 


public void onClick(View v) ( 


switchFragment(ColorFragment.newlInstance(Color.RED, "Red")); 


) 注意 该 方法 
| | | 的 实现 
private void switchFragment(Fragment fragment) { 
FragmentTransaction ft; 
ft = getSupportFragmentManager().beginTransaction(); 
ft.replace(R.id.main fragment container, fragment); 
ft.commit(); 


从 代码 中 可 以 看 出 ，MainActivity 类 需要 继承 自 Fragment-Activity@， 这 样 就 可 以 使 用 Fragment。 然 后 ， 获 取 一 个 Tab 按 
钮 ， 并 为 其 设置 点 击 监 听 器 。 在 该 监听 器 中 调用 switchFragment () 方法 ， 传 入 该 方 法 的 参数 是 一 个 Fragment 的 新 实例 O@。 
最 后 ， 仔 细 阅 读 switchFragment () 方法 的 实现 代码 @， 该 方法 用 于 处 理 在 容器 内 显示 Fragment 的 逻辑 。 


47.3 概要 


通过 目 己 的 实现 万 式 处 理 Tab 听 起 来 有 后 大 材 小 用 ， 但 是 ,假如 开 友 者 需要 为 Tab 添 加 漂亮 的 动画 ， 我 还 是 建议 使 用 类 似 这 
个 Hack 里 提供 的 方式 。 一 句 话 ， 如 果 开发 者 对 UI 控件 有 足够 的 控制 权 ， 残 可 以 很 容易 地 定制 这 些 UI1。 


47.4 外 部 链接 


http:;//developer.android.com/reference/android/app/Activity-Group.html 


http:;//developer.android.com/reference/android/app/TabActivity.html 


第 12 章 ”构建 工具 


在 构建 (build) 应 用 程序 时 ， 开 友 者 经 常 需要 添加 一 些 自 定义 流程 ， 例 如 添加 依赖 天 系 、 运 行 测试 代码 、 在 服务 器 部 署 程 
序 等 。 如 果 读 者 认为 Eclipse 构 建 应 用 程序 的 功能 有 限 ， 那 么 一 定 会 对 本 章 内 容 感 兴趣 的 。 在 本 草 ， 我 会 涵 医 一 些 拷 巧 ， 为 构建 
应 用 程序 提供 一 些 备 选 方 案 。 


Hack 48 ”使 用 Apache Maven 处 理 依 赖 关系 


Android v1.0 十 


Android SDK 提 供 了 很 多 类 库 用 于 创建 应 用 程序 ， 但 是 ， 很 多 时 候 这 些 类 库 是 不 够 的 。 例 如 ， 如 果 开 上 者 想 使 用 Google 
Analytics 或 者 JSON parser 的 功能 ， 就 必须 添加 一 些 依赖 关系 。Android SDK 并 没有 提供 处 理 依赖 关系 的 方法 ， 只 能 将 JAR 文 件 
放 在 /libs 文 件 夹 下 。 玫 和 运 的 是 ， 我 们 可 以 借用 其 他 构建 工具 。 即 使 读者 没有 用 过 第 三 方 依赖 库 ， 也 可 能 需要 把 应 用 程序 分 割 到 不 
同 的 模块 中 ， 并 人 在 模块 间 添 加 依赖 关系， 以 便 可 以 更 好 地 组 织 代码 或 者 创建 可 复 用 的 组 件 。 要 完成 上 述 需 求 ， 开 上 友 者 可 以 使 用 
Apache Maven。 在 这 个 Hack 里 ， 读 者 会 看 到 如 何 使 用 Apache Maven 构 建 应 用 程序 并 运行 测试 代码 。 


如 果 读 者 曾经 使 用 过 Maven 来 处 理 Java 应 用 程序 的 依赖 关系， 你 一 定 会 认可 这 个 强大 的 工具 ， 但 是 掌握 该 工具 需要 化 费 一 
定时 间 。 在 这 个 Hack 里 ， 我 们 会 分 析 Manfred Moser 开 友 的 roboguice-calculator 演 示 程 序 。 在 这 个 演示 程序 中 ，Manfred 使 
用 了 不 同 的 依赖 关系。 因此 ， 该 程序 是 演示 Maven 工 作 原 理 的 绝 佳 例子 。 


要 理解 Maven 的 工作 原理 ， 我 们 需要 分 析 pom.xml 文 件 的 各 个 不 同 片段 。pom.xml 文 件 是 需要 在 项 目 中 配置 的 唯一 一 个 与 
Maven 相 关 的 文件 。 在 该 文件 中 ， 我 们 需要 向 Maven 提 供应 用 程序 的 名 称 、 构 建 时 所 需 的 依赖 关系 、 测 试 相关 的 依赖 天 系 以 及 
如 何 创建 APK。Maven 首 先 检查 这 些 依赖 关系 是 否 存 在 于 本 地 仓库 (local repository) 。 默 认 情 况 下 ， 本 地 仓库 的 路 径 是 
~/.m2/repository。 如 果 在 本 地 仓库 中 没有 找到 指定 的 依赖 关系 ，Marven 会 从 中 心 仓 库 ![] (central repository) 中 下 载 依赖 


首先 分 析 pom.xml 文 件 中 的 第 一 段 代 码 ， 如 下 所 示 : 





<?xml version-"1.0" encoding="UTF-8"?> groupld, arti- 

与 其 他 «project Pe RE factId 、version 
XMI re xmins:xsi-"http://www.w3.org/2001/XMLSchema-instance" 以 及 packaging 
X xsi:schemaLocation-"http://Maven.apache.org/POM/4.0.0 bs 155 Ww z 

件 FÉ, http://Maven.apache.org/Maven-v4 0 O0.xsd"'» br E 为 仓 
JF k € «modelVersion»4.0.0«/modelVersion» 库 中 的 构件 
要 指 XE «groupId»org.roboguice«/groupId» g (artifact) 建立 
schema 和 «artifactId»calculator«/artifactId» 唯一 标识 ， 大 
namespace sversion-1.0-SNAPSHOT«/version» Ek Ew. 351p 

«packaging»apk-c/packaging» 于 坐标 


<name>calculator</name> 


最 终 的 构建 结果 会 存在 于 $MVN_REPO/groupld/artifactld/version 中 。 通 常情 况 下 ， 示 例 程序 会 使 用 groupld 作 为 项 目 


名 ， 使 用 artifactld 作 为 模块 名 。 在 本 例 中 ，Manfred 之 所 以 使 用 org.roboguice 作 为 项 目 名 ， 是 因为 本 例 是 基于 roboguicel 人 项 
目 开 发 的 。 在 该 项 目 中 ，artifactld 和 calculator 用 于 标识 当前 示例 程序 。 


最 后 两 个 属性 是 packaging 和 name。packaging 为 Maven 指 定 最 终 输出 文件 的 类 型 ， 黑 认 值 为 jar。 因 为 我 们 需要 创建 一 个 
Android 应 用 程序 ， 所 以 Manfred 将 该 值 指定 为 apk。name 和 version 共 同 决定 输出 文件 的 名 字 。 


接 下 来 分 析 pom.xml 文 件 中 的 第 二 部 分 代码 : 依赖 天 系 (dependency) 。 因 为 配置 依赖 关系 的 列表 很 长 ， 我 们 只 分 析 其 中 
几 个 依赖 天 系 。 依 赖 天 系 相关 代码 如 下 所 示 : 


«dependencies» 

«dependency» 
«groupId»org.roboguice-c/groupId» 
«artifactId»roboguice-c/artifactIid» a—. dk 
«version»2.0-SNAPSHOT-«/version» 

</dependency> 


roboguice 


Android 


<dependency> 
<groupId>com.google.android</groupId> < 一 fici 
«artifactId»android«/artifactId» 
«version»2.3.3«/version» 
«scope»provided-c/scope» 
</dependency> 


<dependency> 
<groupId>com.pivotallabs</groupId> 
«artifactlId»robolectric«/artifactId» <q AK 
«version»1.0«/version» 


robolectric 





«scope»test«c«/scope» 
</dependency> 
</dependencies> 


每 个 依赖 天 系 都 有 四 个 重要 属性 ， 即 groupld、artifactld、version 和 scope。 第 一 个 依赖 天 系 是 roboguice@， 定 义 了 
groupld、artifactld 以 及 version 属 性 ， 用 于 关联 某 个 Maven 仓 库 中 依赖 关系 的 一 个 发 布 版 本 。 还 记得 第 一 部 分 的 代码 吗 ? 如果 
有 人 需要 将 artifact 作 为 一 个 依赖 天 系 ， 融 需要 这 些 信息 了 。 


尽管 roboguice 依 赖 关 系 没有 包 仿 scope 属性， 读者 应 该 知道 其 使 用 了 默认 值 Ccompile。 因 为 编译 沁 围 的 依赖 关系 
(Compile Dependencies) 会 被 打包 到 APK 中 ， 因 此 这 种 依赖 关系 在 项 目 所 有 类 路 径 (classpath) 中 可 用 。 


下 一 个 依赖 天 系 是 Android 本 身 @。 使 用 Maven 编 译 Android 应 用 程序 时 ， 必 须 将 Android 视 为 一 种 依赖 关系 ， 这 种 依赖 天 
系 的 scope 属 性 值 为 provided。provided 与 compile 有 很 多 相似 之 处 ， 但 是 ，provided 表 示 希 望 在 运行 时 由 JDK 或 者 容器 提供 依 
赖 关系 。 本 例 由 运行 Android 的 设备 提供 依赖 关系 。 


最 后 一 种 依赖 关系 是 robolectric@)。robolectric 是 一 个 测试 框架 ， 因 此 我 们 只 在 编译 /运行 测试 代码 的 时 候 需 要 这 种 依赖 关 
系 。 将 scope 设 置 为 test 的 目的 正在 于 此 ， 在 正常 使 用 应 用 程序 时 ， 不 需要 这 种 测试 汽 围 的 依赖 关系 ， 只 有 在 编译 或 者 执行 测试 
代码 的 阶段 才 会 用 到 这 种 依赖 关系 。 


在 pom.xml 文 件 中 ， 位 于 依赖 关系 之 后 的 配置 信息 是 build 部 分 ， 设 部 分 会 包含 plugins 部 分 。 在 这 里 ， 开 发 者 可 以 配置 
Android Maven 揪 件 。 我 们 看 看 下 面 的 代码 是 如 何 实现 的 : 


«puild» 
«plugins» 
«plugin» 
«groupId» 
com.jayway.Maven.plugins.android.generation2 
«/groupld» 
«artifactId» ]H ^E android-Maven- 
android-Maven-plugin 


^ | plugin 的 groupld, 


«/artifactId» 
— PO artifactId 和 version 
3.0.0-SNAPSHOT 属性 
«/version» 
«configuration» ”| 配置 android- 
«androidManifestFile-» Maven-plugin 


$(project.basedir)/AndroidManifest.xml 
«/androidManifestFile-» 
«assetsDirectory» 
$(project.basedir)/assets 
«/assetsDirectory» 
«resourceDirectory» 
$(project.basedir)/res 
«/resourceDirectory» 


«sdk» 
«platform»10«/platform» 
«/sdk» 
«undeployBeforeDeploy-» 
true 
«/undeployBeforeDeploy» 
«/configuration» 
«extensions»truec/extensions» 
«/plugin» 


«/plugins» 
«/build» 


构建 插件 与 依赖 关系 的 工作 原理 相似 。 上 面 的 代码 表示 android-Maven-plugin 插 件 是 如 何 配置 的 @@。 如 果 配 置 依赖 关系 ， 
则 我 们 也 需要 提供 groupld、artifactld 和 version 属 性 。 


读者 会 注意 到 ，Apache Maven 遵 循 “约定 优 于 配置 ” (convention-over-configuration) 的 规 光 ， 旨 在 减少 软件 开 友 人 
员 所 做 决定 的 数量 ， 应 用 简单 而 又 不 失灵 活性 。 配 置 android-Maven-plugin 的 方式 @ 便 是 应 用 这 种 规范 的 好 例子 。 读 者 可 能 会 
想到 将 AndroidManifest.xml 文 件 放 在 其 他 位 置 ， 因 此 提供 了 一 个 属性 用 于 修改 默认 位 置 。 


pom.xml 文 件 准 备 融 绪 后 ， 开 上 友 者 残 可 以 把 Android 应 用 程序 作为 一 个 Maven 构 件 。 如 果 读 者 运行 mvn package 命 令 ， 会 
生成 一 个 存放 APK 的 目标 路 径 。 如 果 读 者 想 在 连接 的 设备 上 安装 应 用 程序 ， 可 以 运行 mvn android: deploy 命 令 。 





[1] 中 心 仓库 是 Maven 上 默认 的 远程 仓库 。 译 者 注 


有 2] 一 种 依赖 注入 库 。 译 者 注 





48.1 概要 
Apache Maven 是 一 个 强大 的 构建 工具 。 不 过 ， 第 一 次 使 用 该 工具 有 点 困难 却 是 实情 。 但 是 ， 如 果 读 者 理解 了 该 工具 的 运 
行 原理 ， 只 需要 生成 pom.xm| 文 件 就 可 以 创建 一 个 项 目 。 


学 握 该 工具 的 最 好 方法 是 学 习 其 他 人 是 如 何 使 用 它 的 。 例 如 ， 读 者 可 以 自己 查看 roboguice 的 pom.xml 文 件 ， 你 会 发 现 该 文 
件 并 不 难 。 


48.2 ”外 部 链接 


http://maven.apache.org/ 
https://github.com/mosabua/roboguice-calculator 
http://code.google.com/p/maven-android-plugin/ 
https://github.com/roboguice/roboguice 
www.robolectric.org 
http:;//en.wikipedia.org/wiki/Convention over Configuration 


www.simpligility.com 


Hack49 ”在 root 过 的 设备 上 安装 依赖 库 
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Android 应 用 程序 通常 都 是 用 Java 语 言 编 写 的 ， 这 些 代码 会 被 编译 为 字 书 码 。 不 过 ， 在 将 应 用 程序 安 六 到 设备 上 之 前 ， 这 些 
与 Java 虚 拟 机 兼容 的 .class 字 节 码 文件 会 被 转换 为 与 Dalvik 虚 拟 机 兼容 的 .dex 文 件 。 图 49-1 ( 见 49.5 节 ) 演示 了 应 用 程序 的 构建 


过 程 。 


除了 Android SDK 中 提供 的 APl， 我 们 还 可 以 依赖 其 他 第 三 方 库 。 这 些 依赖 库 可 以 为 应 用 程序 提供 更 多 功能 、 更 好 地 组 织 代 
码 、 优 化 目 定 义 视 图 等 。 当 把 这 些 依赖 库 添 加 a 到 应 用 程序 后 ， 我 们 会 友 现 构建 时 间 增 加 了 。Android 支 持 添加 JAR 包 作为 依赖 
库 ， 但 是 每 次 构建 代码 时 ， 都 需要 移 将 JAR 包 中 的 .class 文 件 转化 为 .dex 文 件 ， 这 样 便 消 耗 了 大 量 时 间 。 人 在 上 图 中 ， 我 们 把 天 注 
岂 定 位 到 上 述 流程 ， 如 图 49-2 所 示 。 


对 于 如 何 解 决 上 述 问 题 ， 我 可 以 给 出 一 点 提示 。 读 者 在 Android 中 使 用 过 Google 的 地 图 库 吗 ? 还 记得 是 如 何 添加 这 个 依赖 
库 的 吗 ? 读者 可 以 在 应 用 程序 中 使 用 地 图 库 ， 但 是 却 不 需要 花费 时 间 这 引 这 个 库 ， 这 是 因为 该 库 已 经 被 安装 在 设备 /模拟 器 上 
d 


在 这 个 Hack 里 ， 我 们 使 用 同样 的 方法 ， 只 是 处 理 的 是 其 他 库 。 我 们 会 看 到 如 何在 开 友 设 备 上 安 妆 这 些 依赖 库 ， 以 避 过 依赖 
库 的 dex 转 换 阶 段 ， 节 和 省 构建 时 间 。 


对 于 这 个 Hack， 首 先 要 明白 ， 我 们 只 是 把 依赖 库 安装 在 已 经 root 过 的 设备 上 。 这 意味 着 这 种 方法 无 法 应 用 于 最 终 产 品 上 。 


使 用 该 方法 的 目的 是 为 了 节省 开发 阶段 构建 应 用 程序 的 时 间 。 
应 用 程序 
| .aidl 文件 










atn 


















编译 后 的 | 
Ea 其 他 资源 


重要 存储 库 






signed.apk 和 
Aligned.apk 


图 49-1 应 用 程序 构建 过 程 ， 摘 自 Android 开 发 文档 





图 49-2 编译 流程 


49.1 ”dex 预 处 理 


第 一 步 是 对 依赖 库 进行 
步 是 对 依赖 库 进 行 dex 预 处 理 ， 也 即 首 先 将 JAR 文 件 转化 为 Dex 文 件 。 可 以 通过 ANDROID_SDK/tools 目 录 下 提供 的 d 
A 之 AETAXHJOX 


工具 完成 上 述 操作 。 举 例 况 明 ， 如 果 依 赖 库 是 depjar， 我 们 需要 运行 以 下 命令 : 


dx -JXmx1024M -JXms1024M -JXss4M 
--no-optimize --debug --dex 
--output-./dep dex.jar dep.jar 


我 们 会 把 生成 的 dep dex.jar 文 件 上 传 到 设备 中 。 


49.2 ”创建 与 权限 相关 的 XMLxX 件 


第 二 步 是 创建 XML 文 件 ， 为 每 个 依赖 库 指定 权限 。 回 想 下 Google 地 图 依赖 库 ， 如 果 我 们 需要 使 用 该 库 ， 就 要 在 Android- 
Manifest.xml 文 件 中 添加 use-library 标 签 。 该 标签 指定 的 行 会 用 到 我 们 将 要 创建 的 XML 文 件 。 示 例 代 码 如 下 所 示 : 


<permissions> 


«library name-"dep" < Q 指定 库 名 
file-"/data/data/com.dep.package/files/dep dex.jar"/» < 指定 需要 dex 预 


</permissions> 


O 处 理 的 文件 路 径 
首先 需要 指定 库 名 @， 该 库 名 便 是 use-library 标 签 中 使 用 的 库 名 。 此 外 ， 还 需要 指定 已 经 经 过 dex 预 处 理 的 文件 在 设备 上 的 


人 存储 路 径 @。 可 以 使 用 adb 命 令 或 者 通过 一 个 Android 应 用 程序 把 经 过 dex 预 处 理 的 文件 上 传 到 设备 上 。 在 Android 的 示例 代码 
中 提供 了 一 个 上 传 这 种 文件 的 示例 程序 ， 该 程序 修改 目 Jjohannes Rudolph 编 写 的 scalaandroid-libs 源 代码 。 


49.3 ”修改 AndroidManifest.xml 文 件 
最 后 一 步 是 修改 AndroidManifestxml 文 件 ， 以 便 使 用 安装 在 设备 上 的 依赖 库 。 使 用 上 文中 提 到 的 dep 库 的 方法 如 下 所 示 : 
«uses-library name-"dep"/» 


融 这 么 简单 。 现 在 ， 我 们 融 可 以 从 设备 上 使 用 这 些 依赖 库 ， 而 不 必 企 每 次 运行 应 用 程序 的 时 候 编译 这 些 依赖 库 。 此 外 ， 还 要 
记得 修改 构建 工具 的 配置 ， 以 避免 编译 这 些 依赖 库 。 例 如 ， 在 Apache Maven 中 ， 可 以 将 scope 属 性 设置 为 provided。 


49.4 概要 


在 设备 上 安 妆 依 赖 库 是 节省 应 用 程序 构建 时 间 的 好 方法。 我 在 多 个 应 用 程序 上 使 用 过 这 种 万 法 ， 可 以 将 构建 速度 提 局 一 倍 。 


尽管 这 个 Hack 很 有 用 ， 但 是 有 两 个 方面 比较 态 烦 : 第 一 个 方面 是 ， 读 者 需要 一 个 root 过 的 设备 。 很 遗憾 ， 并 不 是 所 有 
Android 设 备 都 经 过 root。 另 一 方面 是 ， 读 者 还 需要 修改 构建 脚本 以 避免 运行 于 目标 产品 上 。 在 这 种 情况 下 ,Apache Mavenn] 


以 作为 处 理 不 同类 型 构建 过 程 的 好 工具 。 


49.5 ”外 部 链接 


http://developer.android.com/tools/building/index.html 
https://github.com/scala-android-libs/scala-android-libs 


http://android-argentina.blogspot.com/201 1/11/roboinstaller-install-roboguice.html 


Hack 50 ”使 用 Jenkins 处 理 设备 多 样 性 


Android v1.6+ 
由 Christopher Orr 提供 


有 时 候 ， 测 试 Android 应 用 程序 是 一 项 环 手 的 工作 。 数 以 百 计 的 三 商 生 产 了 数 以 干 计 的 独特 的 Android 机 型 ， 一 人 台 设 备 几 乎 
需要 满足 各 种 需求 。 但 是 对 于 软件 开发 者 来 说 ， 这 种 普遍 存在 的 现象 市 来 了 一 个 挑战 : 如 何 确 保 应 用 程序 可 以 很 好 地 运行 于 所 有 
设备 ， 可 以 兼容 各 种 尺寸 的 屏幕 以 及 各 种 硬件 配置 和 各 种 Android 操 作 系 统 版 本 。 


购买 成 百 上 干 的 设备 用 于 开 友 和 测试 是 不 可 行 的 。 值 得 庆 盏 的 是 ，Android 提 供 了 一 个 很 好 的 资源 系统 ， 通 过 该 系统 ， 开 友 
者 只 需要 使 用 一 个 单独 的 应 用 程序 包 束 可 以 支持 各 种 设备 以 及 操作 系统 版 本 。 但 是 ， 如 果 要 验证 是 否 正确 使 用 了 资源 系统 ， 需 要 
做 大 量 测试 ， 例 如 : 有 没有 在 XML 布局 文件 中 为 layout-xhdpi-land 输 入 了 错误 的 视图 ID? 有 没有 在 日 文 翻译 中 漏 掉 一 个 字符 串 
参数 ?由 于 不 同 版 本 的 Android 绑 定 的 SQLite 版 本 经 常会 友 生 变化 ， 开 友 者 是 不 是 写 了 一 条 只 能 运行 于 特定 版 本 的 SQL 查 询 语 
&J? 


挑选 几 种 设备 测试 应 用 程序 ， 不 管 是 手动 测试 还 是 使 用 目 动 化 测试 套件 ， 都 是 可 行 的 。 但 是 ， 这 种 方法 非常 耗 时 ; 而 且 ， 随 
着 应 用 程序 的 友 展 ， 需 要 添加 更 多 特性 、 支 持 更 高 的 屏幕 密度 以 及 更 多 的 设备 类 型 和 语言 类 型 ,很 快 ， 开 友 者 会 友 现 这 种 方法 是 
不 切实 际 的 。 

为 了 减少 测试 负担 ， 在 这 个 Hack 里 ， 读 者 会 看 到 如 何 上 自动 生成 具备 各 种 软件 和 硬件 属性 的 多 种 Android 模 拟 器 ， 并 在 这 些 
模拟 器 上 运行 目 动 化 测试 套件 。 这 样 ， 开 友 者 就 可 以 在 特定 的 设备 配置 上 精确 定位 潜在 的 问题 。 

虽然 模拟 器 无 法 完全 茶 代 实际 硬件 设备 ， 但 是 这 种 方法 可 以 快速 灵活 地 测试 应 用 程序 如 何 应 对 各 种 硬件 属性 ， 例 如 : 设备 是 
人 否 有 前 置 摄像 头 、 是 否 安 半 9D 卡 、 是 人 否 有 硬件 键盘 、 是 否 配备 了 有 限 的 RAM ， 等 等 。 

我 们 会 用 到 一 球 名 为 Jenkins 的 软件 
于 Web 的 操作 界面 如 图 50-1 所 示 。 





种 流行 的 开源 可 持续 化 集成 服务 器 ， 并 附 市 一 个 Android 模 拟 器 插件 。Jenkins 基 
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图 50-1 Jenkins 操 作 界 面 


这 个 Hack 的 宗旨 是 创建 一 个 Jenkins 的 Matrix Job。 对 于 每 次 检 入 (check-in) 的 源码 ， 会 通过 Jenkins 构 建 应 用 程序 ， 自 
动 生成 模拟 器 ， 在 每 个 模拟 器 上 运行 自动 化 测试 套件 并 报告 执行 结果 。 


如 果 读 者 还 没有 一 套 自动 化 测试 套件 ， 可 以 使 用 类 似 Robotium 这 样 的 库 相对 快速 地 创建 一 套 一 一 即便 是 从 几 条 基本 的 冒 烟 
测试 (smoke test) 开始 也 是 有 帮助 的 ， 例 如 ， 确 保 打开 几 个 关键 Activity 并 显示 出 期 望 的 UI 效果 。 


假如 已 经 运行 了 安装 过 Android 模 拟 器 插件 的 Jenkins， 并 且 Jenkins 可 以 访问 包含 应 用 程序 代码 以 及 测试 代码 的 代码 仓库 
(都 可 以 在 本 Hack 的 示例 代码 中 得 到 ) 。 这 里 要 做 的 第 一 件 事 便 是 选择 在 哪些 模拟 器 上 测试 应 用 程序 。 最 低 限 度 下 ， 开 发 者 应 
该 选择 minSdkVersion 与 最 新 版 本 之 | 间 的 每 个 主要 的 Android 操 作 系统 版 本 进行 测试 。 此 外 ， 还 要 考虑 的 因素 有 屏幕 密度 、 本 地 
化 以 及 任何 对 应 用 程序 有 重要 影响 的 硬件 属性 (例如 照相 机 、 加 速 器 等 ) 。 


50.1 创建 Jenkins job 


在 Jenkins 中 ， 点 击 New Job 后 输入 Job 名 称 ， 选 择 Build Multi-configuration Project (也 称 为 Matrix Job) 并 点 击 OK 按 
tH, Matrix Job 人 允许 运行 同一 组 步骤 (对 于 本 例 ， 这 组 步骤 是 局 动 Android 模 拟 器 、 构 建 应 用 程序 、 测 试 应 用 程序 ) ， 但 是 ， 对 
于 每 组 步骤 ， 每 次 运行 时 在 配置 上 会 有 细微 差别 ， 例 如 改变 模拟 器 运行 的 操作 系统 版 本 号 。 


在 Job 配 置信 息 中 ， 首 先 要 输入 源码 管理 信息 以 便 Jenkins 可 以 等 出 (check out) 应 用 程序 并 测试 代码 库 。 针 对 使 用 的 版 本 
控制 系统 ， 上 述 操作 可 能 会 要 求 安装 额外 的 插件 ， 例 如 Git 或 者 Subversion 插 件 ， 可 以 通过 Jenkins 内 置 的 插件 管理 器 安装 这 些 插 
件 。 


为 了 Jenkins 能 够 监控 代码 库 的 变化 ， 需 要 开启 周期 性 构建 选项 ， 输 入 cron 风 格 几 的 语句 。 举 例 说 明 ， 如 果 要 在 工作 日 期 
间 ， 每 两 分 钟 轮 询 一 次 变化 ， 就 输入 以 下 语句 : 


* / 也 大 大 大 1-5 


在 Matrix 配 置 标题 下 方 ， 点 击 “Add Axis" , %4% “User-defined Axis" ， 在 Name 区 域 输 入 os， 在 Values 区 域 ， 输 入 以 
下 语句 : 


Ara 5399 4:92 Ha 59 d. 


读者 可 能 已 经 想到 ， 每 个 值 代 表 一 个 要 测试 的 Android 版 本 。 以 后 ， 还 可 以 进一步 为 屏幕 密度 、 本 地 化 等 添加 Axis， 但 是 ， 
现在 我 们 只 关注 一 种 Axis。 通 过 输入 4 个 非 重复 值 ， 每 当局 动 这 个 job 时 ，Jenkins 会 运行 4 个 独立 的 构建 过 程 ， 每 个 构建 过 程 会 
到 为 os 环境 变量 配置 的 不 同 值 。 


接 下 来 ， 在 构建 的 过 程 中 ， 点 击 “Run an Android Emulator during build" , 2ff& "Run Emulator with 
Properties” 中 输入 以 下 值 : 


: Android 操 作 系 统 版 本 : $fos} 
RR BE RR: 240 
屏幕 分 辨 率 : WVGA 


其 他 配置 字段 可 以 保持 不 变 ， 但 是 应 该 取消 “Show Emulator Window" 选项 。 将 ${os} 的 值 设置 为 Android 的 版 本 号 是 头 
了 确保 这 4 个 构建 过 程 的 每 个 过 程 都 会 创建 不 同 的 Android 模 拟 器 。 最 终 的 配置 信息 如 图 50-2 所 示 : 
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图 50-2 ”配置 Axis 并 创建 模拟 器 


在 Build 选 项 中 ， 假 如 已 经 使 用 Android 工 具 为 应 用 程序 和 测试 项 目 生成 了 Ant 构 建 肢 本， 那么 惑 添 加 Install Android 
project Prerequisites 和 Invoke Ant 等 构建 步骤 。 对 于 target 字 段 ， 输 入 clean debug install test, &xxgAdvanced, WFE 
文件 ， 输 入 tests/build.xml (假设 tests 是 测试 套件 的 目录 ) 。 另 外 ， 添 加 一 个 属性 : sdk.dir-$ANDROID HOME, 


如 果 配 置 Android 测 试 套件 的 输出 结果 为 JUnit XML 格 式 (比如 使 用 android-junit-report 项 目 ) ， 读 者 也 可 以 选 定 Post- 
build Actions 部 分 下 的 Publish JUnit Test Result Report 选 项 。 


点 击 Save 按 钮 结束 Job 的 配置 过 程 。 现 在 ， 读 者 便 拥有 了 一 个 Jenkins job。 该 Job 可 以 运行 多 次 ， 每 次 运行 时 都 会 检 出 源 代 
码 ， 局 动 一 个 不 同 的 Android 模 拟 器 ， 然 后 构建 应 用 程序 并 运行 该 应 用 程序 的 测试 套件 。Job 的 页 面 如 图 50-3 所 示 ， 图 中 每 个 小 
球 表示 一 个 配置 (该 配置 便 是 操作 系统 版 本 ) 。 灰 色 的 球 表示 这 个 构建 过 程 还 没有 发 生 。 
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图 50-3 ”显示 配置 信息 和 某 个 构建 过 程 的 项 目 页 面 


[1] 计划 任务 。 





译 者 注 


50.2 ”运行 job 
在 job 页 面 的 左 侧面 板 点 击 Build Now， 几 秒 钟 后 ， 读 者 会 看 到 一 些 球 开始 内 烁 ， 这 预示 着 一 些 “Configurations” 正 在 构 
建 。 


同时 ， 读 者 可 以 通过 点 击 某 个 闪烁 的 球 ， 然 后 点 击 兢 侧 面板 的 监 色 进度 条 来 观察 构建 过 程 。 这 样 会 显示 终端 输出 、 检 出 的 源 
代码 、 自 动 创建 的 模拟 器 以 及 Jenkins 正 在 等 待 模拟 器 启动 等 信息 。 


默认 情况 下 ，Jenkins 会 并 行 运行 两 个 构建 过 程 ， 因 此 在 所 有 事情 完成 忆 前 ， 需 要 等 待 几 分 钟 。 无 论 如 何 ， 第 一 个 构建 过 程 
会 消耗 较 长 时 间 ， 因 为 必须 首次 生成 和 局 动 模拟 器 。 此 外 ， 如 果 没 有 在 运行 Jenkins 的 机 器 上 安装 Android SDK，Jenkins 会 自动 
为 其 安装 ， 这 样 也 会 增加 初次 构建 的 时 间 。 


当 Jenkins 的 侧 边栏 中 的 进度 条 消失 时 ， 构 建 过 程 束 完成 了 。 


因此 ， 仅 仅 人 花费 数 分 钟 的 时 间 ， 你 融 在 4 种 不 同 Android 版 本 上 目 动 测试 了 你 的 软件 一 一 并 且 ， 当 Jenkins 友 现代 码 库 中 有 新 
的 提交 时 ， 会 继续 目 动 运行 上 述 构建 过 程 。 


运行 了 这 个 基本 的 构建 过 程 ， 就 可 以 进一步 添加 axis 来 改进 Jenkins job 的 配置 。 例 如 ， 可 以 为 不 同 屏幕 分 辨 率 添 加 一 个 
axis， 这 样 便 可 以 目 动 创建 模拟 器 以 测试 为 不 同 手 机 或 者 平板 设备 设计 的 布局 文件 。 


也 可 以 通过 Android 模 拟 器 插件 运行 Android monkey 工 具 对 UI 进行 压力 测试 。 不 必 针 对 每 个 提交 创建 Jenkins job, mÆ 


创建 一 个 夜间 运行 的 Jenkins job， 这 样 束 可 以 构建 APK 并 将 其 安 闪 到 模拟 器 上 ， 然 后 针对 应 用 程序 运行 monkey 来 检查 其 不 稳定 


50.3 ”概要 


目 动 运行 Android 测 试用 例 意 味 着 可 以 比 手 动 测试 花费 更 少 的 时 | 间 ， 而 且 对 应 用 程序 的 质量 更 有 把 握 。 
这 个 Hack 提 供 的 实例 程序 包括 一 个 基本 的 Android 应 用 程序 、 测 试 套件 和 一 个 预先 配置 好 的 可 以 用 来 实验 的 Jenkins。 


因为 Jenkins 并 不 仅仅 用 于 自动 化 测试 ， 读 者 可 以 超越 这 个 Hack 里 提供 的 基础 内 容 ， 做 如 下 尝试 : 在 工作 流 中 集成 monkey 
测试 、 检 查 并 监控 Android lint 问 题 、 自 动 为 APK 签 名 、 向 web 服 务 器 发 布 beta 版 本 用 于 测试 ， 等 等 。 


50.4 SNARES 


http:;//opensignalmaps.com/reports/fragmentation.php 
http://Jenkins-ci.org/ 
https://wiki.jenkins-ci.org/display/JENKINS/Android * Emulator- Plugin 
https://wiki.jenkins-ci.org/display/JENKINS/Android + Lint+ Plugin 


https://github.com/jsankey/android-junit-report 


